Search Results for ""

macOS での Hello World

CircleCI の macOS ビルド環境で継続的インテグレーションを開始する方法について説明します。 CircleCI の基本的な操作について確認したい場合は、入門ガイドを参照することをお勧めします。

また、「macOS 上の iOS アプリケーションのテスト」や「iOS プロジェクトのチュートリアル」も併せてご覧ください。

前提条件

作業を行う前に、以下を準備しておく必要があります。

  • CircleCI のアカウント
  • macOS Executor でのビルドを実行できる有料プランのサブスクリプション
  • Xcode がインストールされた Apple コンピューター (サンプル プロジェクトを開く場合)

macOS Executor の概要

macOS ビルド環境 (executor) は iOS と macOS の開発用に提供されるもので、これを使用して macOS および iOS アプリケーションのテスト、ビルド、デプロイを CircleCI 上で行うことができます。 macOS Executor は、macOS 環境でジョブを実行し、iPhone、iPad、Apple Watch、および Apple TV の各シミュレーターへのアクセスを提供します。

macOS Executor をセットアップする前に、サンプル アプリケーションをセットアップする必要があります。

サンプル アプリケーション

このサンプル アプリケーションは簡単な Mac アプリです。5 分間のタイマーが実行され、単体テストが含まれています (このアプリは単に macOS ビルド環境の基礎を説明することを目的としており、実際のアプリケーションはこれよりもはるかに複雑です)。

macOS ビルド環境についての理解を深めていただければ、CircleCI を利用して以下のことが可能になります。

  • コードをプッシュするたびに、macOS VM 上で Xcode を使用してテストを実行する
  • テストが正常に完了した後、コンパイルされたアプリケーションをアーティファクトとして作成してアップロードする

サンプル アプリケーションのリポジトリは GitHub にチェック アウトできます。

サンプルの設定ファイル

このアプリケーションでは、外部ツールや依存関係が使用されていないため、.circleci/config.yml ファイルの内容はきわめて単純です。 各ステップの内容についてコメントを付けて説明しています。

version: 2.1
jobs: # 1 回の実行の基本作業単位
  build: # 「ワークフロー」を使用しない実行では、エントリポイントとして `build` ジョブが必要です
    macos:  # macOS Executor を使用していることを示します
      xcode: 11.3.0 # 選択された Xcode のバージョン
    steps: # 実行する一連のコマンド
      - checkout  # ユーザーのバージョン管理システムからコードをプル ダウンします
      - run:
          # Xcode の CLI ツール「xcodebuild」を使用してテストを実行します
          name: 単体テストの実行
          command: xcodebuild test -scheme circleci-demo-macos
      - run:
          # アプリケーションをビルドします
          name: アプリケーションのビルド
          command: xcodebuild
      - run:
          # Xcode のビルド出力を圧縮し、アーティファクトとして格納できるようにします
          name: 保存のためのアプリ圧縮
          command: zip -r app.zip build/Release/circleci-demo-macos.app
      - store_artifacts: # このビルド出力を保存します  (詳細については https://circleci.com/ja/docs/2.0/artifacts/ を参照)
          path: app.zip
          destination: app

まだ CircleCI の config.yml を編集したことがない方には、わかりにくい部分があるかもしれません。 config.yml の動作の概要については、以降のセクションに記載しているリンク先から確認できます。

macOS でのビルドの基礎について説明しているため、上記のサンプルの config.yml には以下の内容が含まれています。

  • 使用する executor の指定
  • checkout キーによるコードのプル
  • Xcode でのテストの実行
  • アプリケーションのビルド
  • アプリケーションの圧縮と store_artifacts キーによる保存

config.yml ファイルの詳細については、構成リファレンス ガイドを参照してください。

次のステップ

macOS Executor は iOS アプリケーションのテストとビルドに広く使用されていますが、継続的インテグレーションの構成が複雑になる可能性があります。 iOS アプリケーションのビルドやテストについて詳しく知りたい場合は、以下のドキュメントをご覧ください。

また、CircleCI の機能については、以下のドキュメントを確認してください。