iOS プロジェクトのチュートリアル
クラウド 以下のセクションに沿って、CircleCI を使用して iOS アプリケーション プロジェクトのビルド、テスト、デプロイを自動化する方法について説明していきます。
メモ: 「macOS 上の iOS アプリケーションのテスト」や「iOS プロジェクトのチュートリアル」も併せてご覧ください。
概要
アプリケーションで xcodebuild を使用するジョブとステップを記述する方法、CircleCI 環境でコード署名とプロビジョニングプロファイルを設定する方法、および fastlane を使用してデプロイする方法について、順番に説明していきます。
前提条件
- CircleCI にプロジェクトを追加します。詳細については「Hello World」を参照してください。
- このチュートリアルは、対象のプロジェクト用の Xcode ワークスペースに少なくとも 1 つの共有スキームがあり、選択されたスキームにテスト アクションがあることを前提としています。 まだ共有スキームがない場合は、以下の手順に従って Xcode に共有スキームを追加してください。
- プロジェクトの Xcode ワークスペースを開きます。
- 下図のように、Scheme Selector を使用してスキームの管理ダイアログ ボックスを開きます。
- スキームの管理ダイアログで、ビルドするスキームを選択し、[Shared (共有)] チェックボックスをオンにします。
- スキームをコミットし、プッシュします。
テストの実行
iOS プロジェクトでは、fastlane Scan を使用して以下のようにテストを実行できます。
jobs:
build-and-test:
macos:
xcode: 12.5.1
steps:
...
- run:
name: テストの実行
command: fastlane scan
environment:
SCAN_DEVICE: iPhone 6
SCAN_SCHEME: WebTests
サポートされるバージョンの一覧は、iOS アプリのテストに関するドキュメントの「サポートされている Xcode のバージョン」セクションで確認してください。
コード署名と証明書
詳細については「iOS プロジェクトのコード署名の設定」を参照してください。
To further customize your build process to use custom tools or run your own scripts, use the config.yml file, see the Sample 2.0 config.yml document for customizations.
依存関係のインストール
たとえば Homebrew から依存関係をインストールする場合は、run ステップを使用して適切なコマンドを指定します。
steps:
- run:
name: Homebrew 依存関係のインストール
command: brew install yarn
- run:
name: Node 依存関係のインストール
command: yarn install
テストの実行
以下の短い run 構文例のように、run ステップを使用してテストを実行することもできます。
steps:
- run: fastlane scan
デプロイ
fastlane の gym と deliver を使用して CircleCI でアプリケーションをデプロイするには、識別子、リリースを実行するブランチまたはパターン、および複数のコマンドを指定してリリースを実行します。
version: 2.1
jobs:
test:
macos:
xcode: 12.5.1
steps:
- checkout
- run: fastlane scan
deploy:
macos:
xcode: 12.5.1
steps:
- checkout
- run:
name: Deploy
command: fastlane release_appstore
workflows:
test_release:
jobs:
- test
- deploy:
requires:
test
filters:
branches:
only: release
高度な構成
See the Testing iOS Applications on macOS document for more advanced details on configuring iOS projects.
GitHub 上のサンプル アプリケーション
See the circleci-demo-ios GitHub repository for an example of how to build, test and sign an iOS project using Fastlane on CircleCI.
ドキュメントの改善にご協力ください
このガイドは、CircleCI の他のドキュメントと同様にオープンソースであり、GitHub でご利用いただけます。 ご協力いただき、ありがとうございます。
- このページの編集をご提案ください (最初に「コントリビューションガイド」をご覧ください)。
- ドキュメントの問題点を報告する、またはフィードバックやコメントを送信するには、GitHub で issue を作成してください。
- CircleCI は、ユーザーの皆様の弊社プラットフォームにおけるエクスペリエンスを向上させる方法を常に模索しています。 フィードバックをお寄せいただける場合は、リサーチコミュニティにご参加ください。
サポートが必要ですか？
CircleCI のサポートエンジニアによる、サービスに関する問題、請求およびアカウントについての質問への対応、設定の構築に関する問題解決のサポートを行っています。 サポートチケットを送信して、CircleCI のサポートエンジニアにお問い合わせください。日本語でお問い合わせいただけます。
または、サポートサイトから、サポート記事やコミュニティフォーラム、トレーニングリソースをご覧いただけます。
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
