メインコンテンツまでスキップ

MacOSプロジェクトを使い始める

このガイドでは、macOSプロジェクトをBitriseに追加する方法、Xcodeテストを実行する方法、code signingファイルを管理する方法、そして完成したアプリをbitrise.ioとApp Storeにデプロイする方法について説明します。

macOSプロジェクトをBitriseに追加するClick to copy link​

プロジェクトの追加方法は他の場合と同じです。ウィザードの詳しい手順については新しいプロジェクトの追加をご覧ください。このセクションでは、macOS特有の内容について説明します。

スキャナーがmacOSプロジェクトを検出する方法Click to copy link​

プロジェクトスキャナーは、iOSの場合と同様に.xcodeprojファイルと.xcworkspaceディレクトリを探します。両者を区別するために、各ビルド構成のSDKROOTを確認します。macosxという値(またはそれを含むSUPPORTED_PLATFORMSリスト)が設定されている場合はmacOSプロジェクトとして登録され、iphoneosの場合はiOSとして登録されます。

iOSと同様に、Xcodeプロジェクトやworkspaceを持たないPackage.swiftファイルはSwiftパッケージとして扱われ、宣言されたプラットフォームにmacosが含まれている場合はmacOSに一致します。

設定できる項目Click to copy link​

CI configurationの段階では、ウィザードに次の項目が表示されます。

  • Project or workspace path: ビルド対象の.xcodeproj、.xcworkspace、またはPackage.swiftファイル。
  • Scheme name: プロジェクトまたはworkspace内で見つかった共有スキーム。
  • エクスポート方法: Bitriseがアプリをエクスポートする方法(App Store、Developer ID、Development、またはNoneなど)。Noneを選択すると、.appファイルのコピーを再署名せずにエクスポートします。このオプションはSwiftパッケージには表示されません。

macOSアプリのテストClick to copy link​

テストターゲットが定義されている場合、macOSプロジェクトのデフォルトのWorkflowには、Xcodeテストを実行し、その結果をbitrise.ioで確認するために必要な2つのStepsが含まれています。

  • Xcode Test for Mac
  • Deploy to Bitrise.io
Code signingファイル

Xcodeテストの実行と、その結果のBitriseへのデプロイにはcode signingファイルは必要ありません。今はまだ気にしなくて大丈夫です。

Xcode Test for Mac Stepは、あらかじめ定義されたXcodeテストを実行します。デフォルト設定のままで変更する必要はなく、テストが正しく記述されていれば問題なく動作します。同じ設定オプションはXcodeでも確認できます。

Deploy to Bitrise.ioは、次の内容をデプロイします。

  • Xcodeのテスト結果
  • 生のxcodebuildoutputログ

結果はテスト結果の表示で一箇所にまとめて確認できます。

macOSアプリのCode signingとエクスポートClick to copy link​

他の物理デバイスにアプリをインストールしてテストするには、.appまたは.pkgファイルを作成してエクスポートする必要があります。これにはcode signingの設定が必要です。この例では、developmentエクスポート方法を使ってアプリをエクスポートします。この方法でエクスポートしたアプリはTestflightにアップロードできませんが、たとえば社内テスターのデバイスでテストすることができます。

自動プロビジョニング

ここで説明する手順では、Certificate and profile installer Stepを使用した手動プロビジョニングを例としています。ただし、Bitriseは自動プロビジョニングにも対応していますが、これは本ガイドの範囲外です。

以下が必要です。

  • 自動的に作成されるdeployワークフロー
  • Development証明書(.p12証明書ファイル)
  • Developmentタイプのプロビジョニングプロファイル。macOSプロジェクトの場合、プロビジョニングプロファイルのファイル拡張子は.provisionprofileです。
  1. Xcodeでプロジェクトのcode signingタイプを手動または自動(Xcode管理)に設定し、パッケージファイルをローカルで生成します。

  2. code signingファイルを集めてアップロードします。

    このツールを使うとcode signingファイルをBitriseに自動的にアップロードすることもできます。ぜひこの方法をご利用ください。手動でアップロードする場合は、Workflow Editorに移動し、Code signingタブを選択して、それぞれのフィールドにファイルをアップロードしてください。

  3. your appのWorkflow Editorに移動し、左上のWORKFLOWドロップダウンメニューからdeployワークフローを選択します。

  4. WorkflowにCertificate and profile installer Stepが含まれていることを確認します。これはXcode Archive for Mac Stepより前に配置する必要があります(両者の間にXcode Test for Macのような他のStepsを配置することもできます)。

  5. Xcode Archive for Mac Stepのapp/pkg export configs入力グループにあるExport method入力を確認します。

    アプリをBitriseに追加する際にdevelopmentを選択していた場合は、この入力を変更する必要はありません。それ以外の場合は、手動でdevelopmentに設定してください。

    選択可能なオプションは次のとおりです。

    • development: 社内テスト用にDevelopment IDでアプリに署名します。
    • app-store: Mac App Storeでの配布用にアプリに署名してパッケージ化します。
    • developer-id: App Store以外での配布用にDeveloper IDでアプリに署名します。
    • none: 再署名せずにアプリをエクスポートします。

    macOS_export_method.png

  6. ビルドを開始します。

正しいcode signingファイルをアップロードしていれば、Certificate and profile installer Stepがcode signingファイルをインストールし、Xcode Archive for Mac Stepがdevelopmentエクスポート方法で.appまたは.pkgファイルをエクスポートします。ワークフローにDeploy to Bitrise.io Stepが含まれている場合は、ビルドページのArtifactsタブでバイナリパッケージファイルを確認できます。

アプリをApp Store ConnectにデプロイするClick to copy link​

code signingファイルを設定し、社内テスター向けに.appまたは.pkgファイルを作成できたら、次は社外テスターを巻き込み、macOSアプリをApp Storeに公開する段階です。その方法を見ていきましょう。

Developer ID

App Store以外でアプリを配布したい場合は、Developer IDで署名することができます。この方法は本ガイドの範囲外ですが、Bitriseでも同様の手順で、適切なcode signingファイルをアップロードするだけです。

App Storeにデプロイするには、次のcode signingファイルが必要です。

  • Mac App Distribution証明書
  • Mac Installer Distribution証明書
  1. ローカルマシンで、Xcode内のプロジェクトにApp Store code signingを設定し、.appまたは.pkgファイルをエクスポートします。これがローカルで失敗する場合、Bitriseでも必ず失敗します。

  2. code signingファイルを集めてアップロードします。

  3. アプリのWorkflow Editorに移動し、新しいWorkflowを作成します。Workflowドロップダウンメニューの横にある+ボタンをクリックし、新しいWorkflowの名前を入力して、BASED ONドロップダウンメニューでdeployを選択します。これにより、新しいWorkflowは基本のdeploy Workflowのコピーになります。

  4. app/pkg export methodsをクリックし、Xcode Archive for Mac StepのExport Method入力をapp-storeに設定します。

    異なるエクスポート方法で複数のバイナリをエクスポートすることもできます。そのためには、Workflow内でExport macOS Xcode archive Stepを使用します。

  5. ワークフローにDeploy to App Store Connect - Application Loader (formerly iTunes Connect) Stepを追加します。Xcode Archive for Mac Stepの後に配置しますが、できればDeploy to Bitrise.io Stepより前に配置してください。

  6. Deploy to App Store Connect - Application Loader (formerly iTunes Connect) StepにAppleの認証情報を入力します。

    Stepには、次の情報が必要です。

    • Apple ID
    • パスワード(iTunes Connectで二要素認証を使用している場合はアプリケーションパスワード)

    ご安心ください。パスワードがログに表示されたり公開されたりすることはありません。だからこそSENSITIVEとしてマークされています。

以上で完了です。ビルドを開始してください。すべてがうまくいけば、Testflightでアプリを確認できるようになります。そこから、社外テスターに配布したり、App Storeにリリースしたりできます。