Xcode アプリのビルド、テスト、デプロイ

[アーティクル]
03/25/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Pipelines を使用して Xcode プロジェクトをビルドおよびデプロイする方法について説明します。

前提条件

GitHub リポジトリ内の Xcode 9 以降のプロジェクト。プロジェクトがない場合は、「アプリ用の Xcode プロジェクトの作成」を参照してください

パイプラインを作成する

Azure DevOps 組織にサインインし、プロジェクトに移動します。
[パイプライン] に移動し、最初のパイプラインを作成する場合は [新しいパイプライン] または [[パイプラインの作成] を選択します。
最初に、ソースコードの場所として GitHub を選択し、ウィザードの手順を実行します。
サインインするために GitHub にリダイレクトされる場合があります。その場合は、GitHub の資格情報を入力します。
リポジトリの一覧が表示されたら、目的のリポジトリを選択します。
Azure Pipelines アプリをインストールするために、GitHub にリダイレクトされる場合があります。その場合は、[承認してインストール] を選択します。

[構成] タブが表示されたら、[Xcode] を選択します。

新しいパイプラインが表示されたら、YAML に目を通し、その動作を確認します。準備ができたら、[保存および実行] を選択します。
新しい azure-pipelines.yml ファイルを自分のリポジトリにコミットするように求められます。メッセージを確認したら、[保存および実行] をもう一度選択します。

パイプラインの動作を観察する場合は、ビルドジョブを選択します。

今作成して実行したパイプラインは、コードが Xcode テンプレートに適しているように見えるため、自動的に作成されました。

これで、リポジトリで YAML パイプライン (azure-pipelines.yml) が稼働し、カスタマイズできるようになりました。
パイプラインを変更する準備ができたら、[パイプライン] ページでそのパイプラインを選択し、azure-pipelines.yml ファイルを編集します。

パイプラインをカスタマイズするいくつかの一般的な方法については、以下のセクションを参照してください。

ヒント

このトピックの説明に従って YAML ファイルを変更するには、[パイプライン] ページでパイプラインを選択し、[編集] を選択して、azure-pipelines.yml ファイルのエディターを開きます。

ビルド環境

Azure Pipelines を使用すると、独自のインフラストラクチャを設定せずに Xcode でアプリを構築できます。 Xcode は、Azure Pipelines の Microsoft ホステッド macOS エージェントにプレインストールされています。 macOS エージェントを使用してビルドを実行できます。

プレインストールされている Xcode の正確なバージョンについては、Microsoft によってホストされるエージェントに関するページを参照してください。

リポジトリのルートに azure-pipelines.yml という名前のファイルを作成します。次に、次のスニペットを azure-pipelines.yml ファイルに追加して、適切なエージェントプールを選択します。

# https://learn.microsoft.com/azure/devops/pipelines/ecosystems/xcode
pool:
  vmImage: 'macOS-latest'

Xcode を使用してアプリをビルドする

Xcode を使用してアプリをビルドするには、次のスニペットを azure-pipelines.yml ファイルに追加します。これは、既定のスキームを使用して、シミュレーター用に、パッケージ化せずに iOS プロジェクトをビルドするための最小限のスニペットです。自分のプロジェクトの構成に合わせて値を変更してください。これらのオプションの詳細については、Xcode タスクを参照してください。

pool:
  vmImage: 'macos-latest'

steps:
- task: Xcode@5
  inputs:
    actions: 'build'
    scheme: ''
    sdk: 'iphoneos'
    configuration: 'Release'
    xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace'
    xcodeVersion: 'default' # Options: 10, 11, 12, 13, 14, default, specifyPath

署名とプロビジョニング

Xcode アプリをデバイスで実行または App Store に発行するためには、署名してプロビジョニングする必要があります。署名とプロビジョニングのプロセスでは、P12 署名証明書と 1 つ以上のプロビジョニングプロファイルにアクセスする必要があります。 Apple 証明書のインストールおよび Apple プロビジョニングプロファイルのインストールタスクを使用すると、ビルド中に Xcode でこれらを使用できるようになります。

詳細については、「モバイルアプリに署名する」を参照してください。

Carthage

プロジェクトにプライベート Carthage リポジトリで Carthage を使用する場合は、リポジトリにアクセスできるトークンの値を持つ GITHUB_ACCESS_TOKEN という名前の環境変数を設定することで、認証を設定できます。この環境変数が Carthage で自動的に検出されて使用されます。

パイプライン YAML にシークレットトークンを直接追加しないでください。代わりに、[変数] ペインでロックが有効になっている新しいパイプライン変数を作成して、この値を暗号化します。「シークレット変数を設定する」を参照してください。

GITHUB_ACCESS_TOKEN 環境変数の値に myGitHubAccessToken という名前のシークレット変数を使用する例を次に示します。

- script: carthage update --platform iOS
  env:
    GITHUB_ACCESS_TOKEN: $(myGitHubAccessToken)

Azure でホストされるデバイス上でテストする

App Center テストタスクを追加して、iOS と Android デバイスのホストされたラボでアプリをテストします。 App Center の無料試用版が必要です。これは、後で有料に変換する必要があります。

最初に App Center にサインアップします。

# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when enablePrepare = true && framework = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App Center password. 
    appSlug: # string. Required when enableRun = true. App slug. 
    devices: # string. Required when enableRun = true. Devices. 
    #series: 'master' # string. Optional. Use when enableRun = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

ビルドレコードを使用して成果物を保持する

ファイルのコピーおよびビルド成果物の発行タスクを追加して、ビルドレコードを含む IPA を格納するか、後続のパイプラインでテストおよびデプロイします。成果物に関するページを参照してください。

- task: CopyFiles@2
  inputs:
    contents: '**/*.ipa'
    targetFolder: '$(build.artifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
    ArtifactName: 'drop'
    publishLocation: 'Container'

配置

App Center

App Center 配布タスクを追加して、テスト担当者やベータユーザーのグループにアプリを配布するか、アプリケーションを Intune や Apple App Store に昇格します。無料の App Center アカウントが必要です (支払いは不要)。

# App Center distribute v3
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: # string. Required. App Center service connection. 
    appSlug: # string. Required. App slug. 
    appFile: # string. Alias: app. Required. Binary file path. 
    #buildVersion: # string. Build version. 
    releaseNotesOption: 'input' # 'input' | 'file'. Alias: releaseNotesSelection. Required. Create release notes. Default: input.
    releaseNotesInput: # string. Required when releaseNotesSelection = input. Release notes. 
    #releaseNotesFile: # string. Required when releaseNotesSelection = file. Release notes file. 
    #isMandatory: false # boolean. Require users to update to this release. Default: false.
    destinationType: 'groups' # 'groups' | 'store'. Required. Release destination. Default: groups.
    #distributionGroupId: # string. Alias: destinationGroupIds. Optional. Use when destinationType = groups. Destination IDs. 
    #destinationStoreId: # string. Required when destinationType = store. Destination ID. 
    #isSilent: # boolean. Optional. Use when destinationType = groups. Do not notify testers. Release will still be available to install. 
  # Symbols
    #symbolsOption: 'Apple' # 'Apple' | 'Android' | 'UWP'. Alias: symbolsType. Symbols type. Default: Apple.
    #symbolsPath: # string. Optional. Use when symbolsType == AndroidNative || symbolsType = Windows. Symbols path. 
    #appxsymPath: # string. Optional. Use when symbolsType = UWP. Symbols path (*.appxsym). 
    #symbolsDsymFiles: # string. Alias: dsymPath. Optional. Use when symbolsType = Apple. dSYM path. 
    #symbolsMappingTxtFile: # string. Alias: mappingTxtPath. Optional. Use when symbolsType = Android. Mapping file. 
    #nativeLibrariesPath: # string. Optional. Use when symbolsType == Android. Native Library File Path. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Optional. Use when symbolsType = Apple. Include all items in parent folder.

Apple App Store

Apple App Store 拡張機能をインストールし、次のタスクを使用して、App Store との対話を自動化します。既定では、これらのタスクは構成したサービス接続を使用して、Apple に対して認証されます。

リリース

App Store リリースタスクを追加して、App Store にある既存の iOS TestFlight ベータアプリまたは運用アプリへの更新プログラムのリリースを自動化します。

Apple の 2 要素認証でこのタスクを使用する場合の制限事項を参照してください。Apple 認証は地域固有であり、fastlane セッショントークンはすぐに期限切れになり、再作成および再構成する必要があります。

- task: AppStoreRelease@1
  displayName: 'Publish to the App Store TestFlight track'
  inputs:
    serviceEndpoint: 'My Apple App Store service connection' # This service connection must be added by you
    appIdentifier: com.yourorganization.testapplication.etc
    ipaPath: '$(build.artifactstagingdirectory)/**/*.ipa'
    shouldSkipWaitingForProcessing: true
    shouldSkipSubmission: true

昇格

App Store 昇格タスクを追加して、iTunes Connect から以前に送信したアプリの App Store への昇格を自動化します。

- task: AppStorePromote@1
  displayName: 'Submit to the App Store for review'
  inputs:
    serviceEndpoint: 'My Apple App Store service connection' # This service connection must be added by you
    appIdentifier: com.yourorganization.testapplication.etc
    shouldAutoRelease: false

Apple App Store (Microsoft)
Codified Security (Codified Security)
MacinCloud (Moboware Inc.)
Mobile App Tasks for iOS and Android (James Montemagno)
Mobile Testing Lab (Perfecto Mobile)
Raygun (Raygun)
React Native (Microsoft)
Version Setter (Tom Gilder)

Xcode アプリのビルド、テスト、デプロイ

前提条件

パイプラインを作成する

ビルド環境

Xcode を使用してアプリをビルドする

署名とプロビジョニング

Carthage

Azure でホストされるデバイス上でテストする

ビルドレコードを使用して成果物を保持する

配置

App Center

Apple App Store

リリース

昇格

フィードバック

フィードバック

その他のリソース

Xcode アプリのビルド、テスト、デプロイ

前提条件

パイプラインを作成する

ビルド環境

Xcode を使用してアプリをビルドする

署名とプロビジョニング

Carthage

Azure でホストされるデバイス上でテストする

ビルド レコードを使用して成果物を保持する

配置

App Center

Apple App Store

リリース

昇格

関連する拡張機能

フィードバック

フィードバック

その他のリソース

ビルドレコードを使用して成果物を保持する