Linux は Capacitor アプリの開発環境として快適で、Android のビルドも妥協なく行えます。例外は iOS です。Xcode と Apple の署名ツールは macOS でのみ動作します。解決策は机の下に Mac mini を置くことではありません。ローカルで iOS プロジェクトを生成し、クラウド上の macOS でコンパイルすることです。
の Linux 版ガイドです Capacitor と Capgo Build で Windows から iOS アプリをビルドする。Linux 固有の差分、つまり OpenSSL 証明書、Linux シェル、Linux ラナーからの CI について説明します。
役割分担
Capacitor アプリには 2 つのビルドがあります:
- Webビルド: フレームワークの出力を
dist/に。Linux で完了。 - Native Build: Xcode アーカイブ、署名、アップロード。 Capgo のビルド Apple Silicon 搭載の Mac で、最新の macOS と Xcode を実行している場合。
CLIが準備済みの ios/ プロジェクトをローカルマシンから直接ビルドします。Git ホストへのプッシュは不要で、依存関係のインストールと cap sync アップロード前にローカルで実行される処理。
前提条件
- ローカルでビルド可能な Capacitor アプリ(任意のフレームワーク対応)。
- Linux上のNode 20以降、または Bun。
- Apple Developer Program のメンバーシップ。
- OpenSSL(ほとんどのディストリビューションでデフォルトインストール済み)。
- Capgo アカウントと、そこに登録済みのアプリ。
bunx @capgo/cli@latest app add.
1) Linux上でiOSプロジェクトを生成する
bun add @capacitor/core @capacitor/ios
bun add -d @capacitor/cli
bunx cap init
bun run build
bunx cap add ios
次のような表示が出ます: Skipping pod install because CocoaPods is not installed。想定どおりです。この ios/ フォルダが存在しており、コミットする必要があります。ここにはbundle ID、Info.plist、アイコン、ネイティブ設定が含まれます。
2) ビルド前に必ずWebアセットを同期する
bun run build
bunx cap sync ios
cap sync コピーします dist/ 次のように分類しています ios/App/App/public およびプラグインの参照を更新します。Capgo はコンパイル対象の内容を ios/。そのため、同期されていないプロジェクトでは、以前のUIがそのまま配布されてしまいます。
3) Macなしで署名用素材を作成する
3つのものが必要です。Apple Distribution証明書 .p12、App Storeプロビジョニングプロファイル、そしてApp Store ConnectのAPIキーです。Keychain Accessは不要です。
OpenSSLで配布用証明書
openssl genrsa -out ios_distribution.key 2048
openssl req -new -key ios_distribution.key -out ios_distribution.csr \
-subj "/emailAddress=you@example.com/CN=Your Name/C=US"
アップロード ios_distribution.csr 「証明書、識別子、プロファイル」で Apple Distribution を選択し、ダウンロードします distribution.cer。変換して bundle します:
openssl x509 -in distribution.cer -inform DER -out distribution.pem -outform PEM
openssl pkcs12 -export -inkey ios_distribution.key -in distribution.pem \
-out ios_distribution.p12 -legacy
この -legacy OpenSSL 3 ではこの flag が重要です。指定しないと、Apple のツールが .p12 パスワードが正しくても invalid password エラーになることがあります。OpenSSL を直接触りたくない場合は、 iOS証明書ジェネレーター はブラウザでも同じことができます。
プロビジョニングプロファイルと API キー
Apple Developerポータルで、新しい証明書を使うBundle ID用のApp Storeプロファイルを作成し、次をダウンロードします .mobileprovision。App Store Connectで、App Managerロールの API キーを作成し、次をダウンロードします .p8。Key IDとIssuer IDをメモしておいてください。 iOSビルドガイド では各画面を表示します。
Linuxでプロファイルを確認したいですか? openssl smime -inform der -verify -noverify -in profile.mobileprovision を実行すると、埋め込まれたplistが出力されます。
4) 認証情報を Capgo に保存する
bunx @capgo/cli@latest login
bunx @capgo/cli@latest build credentials save \
--platform ios \
--apple-team-id "TEAMID" \
--apple-key ./AuthKey_KEYID.p8 \
--apple-key-id "KEYID" \
--apple-issuer-id "issuer-uuid" \
--certificate ./ios_distribution.p12 \
--ios-provisioning-profile ./App_Store.mobileprovision
または次を実行 bunx @capgo/cli@latest build init --platform ios ガイド付き版はこちら。LinuxではApp Store Connectのキー設定だけ手動で、それ以外はすべてプロンプトに従います。
Appleが認証エラーでキーを拒否する場合は、時計を同期してください。JWTはローカル時刻で署名されるため、時刻が大きくズレたトークンはAppleに拒否されます:
timedatectl status
sudo timedatectl set-ntp true
5) ビルドをリクエストする
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
準備済みの ios/ プロジェクトをアップロードし、Capgo が実行され、 pod installXcodeでアーカイブし、証明書で署名し、ログをターミナルにストリーミングします。API キーが設定されていれば、ビルド完了時にTestFlightへ提出されます。起動するには、iPhoneにTestFlightアプリをインストールしてください。
ビルド失敗の自動診断には、 --ai-analyticsを追加します。 AIビルド診断 はXcodeログを読み取り、修正方法を説明します。
6) TestFlightなしでテスター向けAd hocビルド
UDIDで登録されたQAデバイスには、Ad Hocプロファイルを使用し、IPAを成果物として保持します:
bunx @capgo/cli@latest build request com.example.app \
--platform ios \
--ios-distribution ad_hoc \
--output-upload
CLI は期限付きのダウンロードリンクを出力します。 --output-record build.json を追加して、リンクとテスター用のQRcodeを保存します。
7) Linux CIランナーから自動化
同じコマンドは任意のLinux CIで実行できます。GitHub Actionsの例:
name: iOS build
on:
workflow_dispatch:
jobs:
ios:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: oven-sh/setup-bun@v2
- run: bun install
- run: bun run build
- run: bunx cap sync ios
- run: bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
ステップ4で保存した認証情報はCapgoに格納されるため、ランナーにはトークンのみが必要です。代わりに、CIにエクスポートします .env を使用して bunx @capgo/cli@latest build credentials manage し、値をシークレットとして渡します。詳細は 認証情報の管理.
8) ネイティブビルドなしの日々のイテレーション
TestFlightビルドが存在すれば、その後の変更の多くはWeb側の変更です。これらは Capgo Live Update:
bun run build
bunx @capgo/cli@latest bundle upload --channel production
使用は build request で、プラグインの追加、権限の変更、アイコンの変更、および Capacitor のアップグレードに対応します。
Linuxの落とし穴
- 忘れた場合
cap sync ios:IPAに古いUIが表示されます。リクエストする前に必ず同期してください。 ios/における.gitignore:CLI はディスクからアップロードするためビルドは通りますが、チームメイトやCIにはネイティブプロジェクトが含まれません。コミットしてください。.p12パスワードが拒否されました:再生成するには-legacy.- Apple 認証に失敗しました:時計のズレです。NTP を有効にしてください。
- プラグイン追加後にネイティブ再ビルドを忘れた:Capacitor プラグインを追加するとネイティブバイナリが変わります。それを呼び出す Web 側の変更を配信する前に、新しいクラウドビルドを実行してストア申請してください。
まとめ
Linux では Xcode を実行できませんが、その必要もありません。生成には ios/ Capacitor を使い、OpenSSL でビルド証明書を作成し、Capgo Build にコンパイル、署名、TestFlight への送信を任せます。Web レイヤーには Live Updates を使うことで、Linux のみのチームでも Android と同様に iOS を日常的にリリースできます。環境構築の全体像はこちらをご覧ください。 LinuxでのCapacitor開発.