Xcode ビルドとエクスポート

ソースからアプリをビルドして App Store Connect にアップロードする準備をする必要があるときにこのスキルを使用します。プロジェクトに適している場合は、生の xcodebuild レシピより asc xcode archive と asc xcode export を優先します。

前提条件

• Xcode とコマンドラインツールがインストールされている。
• 署名アイデンティティとプロビジョニングプロファイルが利用可能、または自動署名が有効になっている。
• アップロードまたはビルド参照が必要な場合、App Store Connect 認証が設定されている。

バージョンとビルド番号を管理する

asc xcode version view
asc xcode version edit --version "1.3.0" --build-number "42"
asc xcode version bump --type build
asc xcode version bump --type patch

プロジェクトルートから実行していない場合は --project-dir "./MyApp" を使用してください。ディレクトリに複数のプロジェクトが含まれている場合は --project "./MyApp/App.xcodeproj" を使用してください。マルチターゲットプロジェクトで確実に読み込むには --target "App" を使用してください。

低いビルド番号での拒否を避けるため、まずリモートセーフなビルド番号を解決してください:

asc builds next-build-number --app "APP_ID" --version "1.2.3" --platform IOS --output json
asc xcode version edit --build-number "NEXT_BUILD"

推奨される iOS/tvOS/visionOS ビルドフロー

1. asc でアーカイブする

asc xcode archive \
  --workspace "App.xcworkspace" \
  --scheme "App" \
  --configuration Release \
  --clean \
  --archive-path ".asc/artifacts/App.xcarchive" \
  --xcodebuild-flag=-destination \
  --xcodebuild-flag=generic/platform=iOS \
  --output json

プロジェクトのみのアプリの場合は --workspace の代わりに --project "App.xcodeproj" を使用してください。

2. asc でエクスポートする

asc xcode export \
  --archive-path ".asc/artifacts/App.xcarchive" \
  --export-options "ExportOptions.plist" \
  --ipa-path ".asc/artifacts/App.ipa" \
  --xcodebuild-flag=-allowProvisioningUpdates \
  --output json

ExportOptions.plist が App Store Connect に直接アップロードする場合は、ビルド検出と処理をポーリングするために --wait を追加してください:

asc xcode export \
  --archive-path ".asc/artifacts/App.xcarchive" \
  --export-options "UploadExportOptions.plist" \
  --ipa-path ".asc/artifacts/App.ipa" \
  --wait \
  --output json

3. アップロードまたは公開する

エクスポートされた IPA をアップロード:

asc builds upload --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --wait

TestFlight に配布:

asc publish testflight --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --group "GROUP_ID" --wait

App Store に公開:

asc publish appstore --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --version "1.2.3" --wait
asc publish appstore --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --version "1.2.3" --wait --submit --confirm

macOS App Store フロー

ヘルパーでアーカイブ:

asc xcode archive \
  --project "MacApp.xcodeproj" \
  --scheme "MacApp" \
  --configuration Release \
  --clean \
  --archive-path ".asc/artifacts/MacApp.xcarchive" \
  --xcodebuild-flag=-destination \
  --xcodebuild-flag=generic/platform=macOS \
  --output json

macOS エクスポートが .pkg を生成する場合は、Xcode エクスポートで ExportOptions.plist を使用してからパッケージをアップロード:

xcodebuild -exportArchive \
  -archivePath ".asc/artifacts/MacApp.xcarchive" \
  -exportPath ".asc/artifacts/MacAppExport" \
  -exportOptionsPlist "ExportOptions.plist" \
  -allowProvisioningUpdates

asc builds upload \
  --app "APP_ID" \
  --pkg ".asc/artifacts/MacAppExport/MacApp.pkg" \
  --version "1.0.0" \
  --build-number "123" \
  --wait

.pkg アップロードの場合、IPA メタデータのように自動抽出されないため --version と --build-number が必須です。

生の xcodebuild フォールバック

asc xcode archive/export --help がプロジェクト固有のオプションをカバーしていない場合のみ生の xcodebuild を使用してください。まず --xcodebuild-flag を通じて追加の引数を渡すことを優先してください。

xcodebuild -showBuildSettings -scheme "App"

トラブルシューティング

エクスポート時にバンドル ID のプロファイルがない

• asc xcode export に --xcodebuild-flag=-allowProvisioningUpdates を追加してください。
• Apple ID が Xcode にログインしていることを確認してください。
• asc-signing-setup スキルでプロファイルを確認してください。

CFBundleVersion が低すぎる

asc builds next-build-number --app "APP_ID" --version "1.2.3" --platform IOS
asc xcode version edit --build-number "NEXT_BUILD"

その後、リビルドしてもう一度アップロードしてください。

macOS アイコンの欠落によるビルド拒否

macOS には必要なサイズのすべてを含む ICNS アイコンが必要です。アセットカタログを修正してリビルドし、エクスポート/アップロードを再度実行してください。

注記

• ローカルアーティファクトの決定的な処理のために asc xcode archive と asc xcode export を優先してください。
• 既存のローカルアーティファクトを意図的に置き換えるときのみ --overwrite を使用してください。
• 次のステップが処理されたビルドに依存する場合、アップロード/公開パスで --wait を使用してください。
• 提出準備状況については asc-submission-health を使用してください。