Enumeration
ShipItError
Top-level error type for all ShipItSwifty failures.
enum ShipItErrorOverview
Every Action either throws ShipItError directly or wraps a domain-specific error inside one of its cases. The CLI maps each case to a documented exit code (§7.2).
Exit Codes
Build/Archive/Export (10–12)
Code Signing (20)
API / Upload (30)
Screenshots (40)
Metadata / Precheck / Archive Validation (50)
Configuration / General (2)
Topics
Enumeration Cases
case apiError(statusCode: Int, body: String)App Store Connect API returned an unexpected HTTP status.
case archiveFailed(exitCode: Int, log: String)Archive or IPA export step failed.
case buildFailed(exitCode: Int, log: String)xcodebuildexited with a non-zero code.case duplicateAction(name: String)An action name collision was detected during plugin registration.
case invalidConfiguration(reason: String)Shipfile is missing, unreadable, or contains invalid YAML.
case jwtGenerationFailed(underlying: any Error)JWT generation failed (bad key, missing fields, etc.).
case keychainError(underlying: any Error)Keychain operation failed.
case missingTool(name: String)A required tool (e.g.
xcodebuild,xcrun) was not found onPATH.case precheckFailed(violations: [String])One or more metadata fields failed App Store guideline validation.
case screenshotCaptureFailed(device: String, locale: String, reason: String)Simulator launch or screenshot capture failed.
case signingResourceNotFound(description: String)A required certificate or provisioning profile was not found.
case testFailed(exitCode: Int, failureCount: Int, log: String)Test run exited non-zero or reported test failures.
case uploadFailed(asset: String, reason: String)Asset upload to App Store Connect failed.
case validateArchiveFailed(issues: [String])Archive, IPA, or app bundle failed readiness validation for App Store upload.
Instance Properties
var exitCode: Int32The CLI exit code corresponding to this error.
Default Implementations
Relationships
Conforms To
Foundation.LocalizedErrorSwift.CopyableSwift.ErrorSwift.EscapableSwift.SendableSwift.SendableMetatype