Compilar, testar e implementar aplicações Xcode

Artigo
03/25/2024

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Saiba como criar e implantar projetos Xcode com o Azure Pipelines.

Pré-requisitos

Um projeto Xcode 9+ em um repositório GitHub. Se você não tiver um projeto, consulte Criando um projeto Xcode para um aplicativo

Criar o pipeline

Entre na sua organização do Azure DevOps e vá para o seu projeto.
Vá para Pipelines e selecione Novo pipeline ou Criar pipeline se estiver criando seu primeiro pipeline.
Siga as etapas do assistente selecionando primeiro o GitHub como o local do código-fonte.
Poderá ser redirecionado para o GitHub para iniciar sessão. Em caso afirmativo, insira suas credenciais do GitHub.
Quando vir a lista de repositórios, selecione o repositório.
Você pode ser redirecionado para o GitHub para instalar o aplicativo Azure Pipelines. Em caso afirmativo, selecione Aprovar e instalar.

Quando a guia Configurar for exibida, selecione Xcode.

Quando seu novo pipeline aparecer, dê uma olhada no YAML para ver o que ele faz. Quando estiver pronto, selecione Salvar e executar.
Você será solicitado a confirmar um novo arquivo de azure-pipelines.yml no repositório. Depois de ficar satisfeito com a mensagem, selecione Salvar e executar novamente.

Se você quiser ver seu pipeline em ação, selecione o trabalho de compilação.

Você acabou de criar e executar um pipeline que criamos automaticamente para você, porque seu código parecia ser uma boa correspondência para o modelo Xcode .

Agora você tem um pipeline YAML funcional (azure-pipelines.yml) em seu repositório que está pronto para você personalizar!
Quando estiver pronto para fazer alterações no pipeline, selecione-o na página Pipelines e edite o azure-pipelines.yml arquivo.

Consulte as seções abaixo para aprender algumas das maneiras mais comuns de personalizar seu pipeline.

Gorjeta

Para fazer alterações no arquivo YAML conforme descrito neste tópico, selecione o pipeline na página Pipelines e, em seguida, selecione Editar para abrir um editor para o azure-pipelines.yml arquivo.

Ambiente de construção

Você pode usar o Azure Pipelines para criar seus aplicativos com o Xcode sem precisar configurar nenhuma infraestrutura própria. O Xcode está pré-instalado em agentes macOS hospedados pela Microsoft no Azure Pipelines. Você pode usar os agentes do macOS para executar suas compilações.

Para obter as versões exatas do Xcode que estão pré-instaladas, consulte Agentes hospedados pela Microsoft.

Crie um arquivo chamado azure-pipelines.yml na raiz do repositório. Em seguida, adicione o seguinte trecho ao arquivo azure-pipelines.yml para selecionar o pool de agentes apropriado:

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

Crie um aplicativo com o Xcode

Para criar um aplicativo com o Xcode, adicione o seguinte trecho ao seu azure-pipelines.yml arquivo. Este é um trecho mínimo para construir um projeto iOS usando seu esquema padrão, para o simulador e sem empacotamento. Altere os valores para corresponder à configuração do projeto. Consulte a tarefa Xcode para obter mais informações sobre essas opções.

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

Assinatura e provisionamento

Um aplicativo Xcode deve ser assinado e provisionado para ser executado em um dispositivo ou publicado na App Store. O processo de assinatura e provisionamento precisa de acesso ao seu certificado de assinatura P12 e a um ou mais perfis de provisionamento. As tarefas Instalar Certificado Apple e Instalar Perfil de Provisionamento Apple disponibilizam-nas para o Xcode durante uma compilação.

Consulte Assinar seu aplicativo móvel para saber mais.

Cartago

Se o seu projeto usa Carthage com um repositório Carthage privado, você pode configurar a autenticação definindo uma variável de ambiente nomeada GITHUB_ACCESS_TOKEN com um valor de um token que tem acesso ao repositório. Carthage irá detetar automaticamente e usar esta variável de ambiente.

Não adicione o token secreto diretamente ao seu pipeline YAML. Em vez disso, crie uma nova variável de pipeline com seu bloqueio habilitado no painel Variáveis para criptografar esse valor. Veja variáveis secretas.

Aqui está um exemplo que usa uma variável secreta nomeada myGitHubAccessToken para o valor da variável de GITHUB_ACCESS_TOKEN ambiente.

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

Testando em dispositivos hospedados no Azure

Adicione a tarefa Teste do App Center para testar o aplicativo em um laboratório hospedado de dispositivos iOS e Android. É necessária uma versão de avaliação gratuita do App Center, que deve ser posteriormente convertida em paga.

Registe-se primeiro com o 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.

Reter artefatos com o registro de compilação

Adicione as tarefas Copiar arquivos e Publicar artefatos de compilação para armazenar seu IPA com o registro ou teste de compilação e implantá-lo em pipelines subsequentes. Veja Artefatos.

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

Implementar

App Center

Adicione a tarefa Distribuir do App Center para distribuir uma aplicação a um grupo de testadores ou utilizadores beta ou promova a aplicação para o Intune ou para a Apple App Store. É necessária uma conta gratuita no App Center (não é necessário pagamento).

# 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

Instale a extensão Apple App Store e use as seguintes tarefas para automatizar a interação com a App Store. Por padrão, essas tarefas são autenticadas na Apple usando uma conexão de serviço configurada por você.

Versão

Adicione a tarefa Lançamento da App Store para automatizar o lançamento de atualizações para aplicativos beta ou aplicativos de produção existentes do iOS TestFlight na App Store.

Veja as limitações de usar essa tarefa com a autenticação de dois fatores da Apple, já que a autenticação da Apple é específica da região e os tokens de sessão fastlane expiram rapidamente e devem ser recriados e reconfigurados.

- 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

Promover

Adicione a tarefa Promover da App Store para automatizar a promoção de uma aplicação submetida anteriormente a partir do iTunes Connect para a 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)
Segurança codificada (Segurança codificada)
MacinCloud (Moboware Inc.)
Tarefas de aplicativos móveis para iOS e Android (James Montemagno)
Laboratório de testes móveis (Perfecto Mobile)
Raygun (Raygun)
React Native (Microsoft)
Versão Setter (Tom Gilder)

Compilar, testar e implementar aplicações Xcode

Pré-requisitos

Criar o pipeline

Ambiente de construção

Crie um aplicativo com o Xcode

Assinatura e provisionamento

Cartago

Testando em dispositivos hospedados no Azure

Reter artefatos com o registro de compilação

Implementar

App Center

Apple App Store

Versão

Promover

Comentários

Comentários

Recursos adicionais

Compilar, testar e implementar aplicações Xcode

Pré-requisitos

Criar o pipeline

Ambiente de construção

Crie um aplicativo com o Xcode

Assinatura e provisionamento

Cartago

Testando em dispositivos hospedados no Azure

Reter artefatos com o registro de compilação

Implementar

App Center

Apple App Store

Versão

Promover

Extensões relacionadas

Comentários

Comentários

Recursos adicionais