Criando aplicativos Objective-C ou Swift para iOS

Para criar seu primeiro aplicativo iOS nativo, você deve tomar as seguintes ações:

  1. Conectar-se à sua conta de serviço do repositório (GitHub, Bitbucket, VSTS, Azure DevOps)
  2. Selecione um repositório e um branch em que seu aplicativo reside
  3. Configurar o projeto ou o workspace do build e o esquema que você deseja criar

Observação

Para executar o aplicativo em um dispositivo real, o build deve ser um código assinado com um perfil de provisionamento e um certificado válidos.

1. Vincular seu repositório

Se você ainda não se conectou à sua conta de serviço do repositório, deverá autorizar a conexão. Depois que sua conta estiver conectada, selecione o repositório em que seu projeto do iOS está localizado. App Center requer que sua conta tenha permissões de Administrador e Pull para configurar um build para um repositório.

2. Selecionar um branch

Depois de selecionar um repositório, selecione o branch que você deseja criar. Por padrão, todos os branches ativos serão listados.

3. Configurando seu primeiro build

Configure seu projeto do iOS antes do primeiro build.

3.1 Projeto/workspace e esquema

Para uma configuração de build, um projeto Xcode ou um workspace do Xcode e um esquema compartilhado são necessários. App Center detecta automaticamente os projetos, espaços de trabalho e esquemas compartilhados (desde que os esquemas estejam na pasta correta) em seu Branch. Selecione o projeto ou o espaço de trabalho que você deseja compilar e o esquema correspondente.

Se nenhum esquema for encontrado, verifique se o esquema que você deseja é compartilhado e seu contêiner é o projeto ou o espaço de trabalho que você selecionou. Você também deve confirmar que essas alterações são verificadas na ramificação que você está configurando.

Tenha em mente que você não pode exportar um .xcscheme arquivo e colocá-lo em qualquer lugar no projeto. Ele deve estar na xcshareddata/xcschemes/ pasta. Certifique-se de que esse caminho não esteja em seu .gitignore arquivo.

Marcar esquema como compartilhado

3.2. Versão do Xcode

Selecione a versão do Xcode na qual executar a compilação.

3.3. Gatilhos de compilação

Por padrão, uma nova compilação é disparada toda vez que um desenvolvedor envia por push para uma ramificação configurada. Esse processo é conhecido como "integração contínua". Se você preferir disparar uma nova compilação manualmente, poderá alterar essa configuração na configuração da compilação.

3.4. Número de Build de incremento

Quando habilitado, o CFBundleVersion no Info.plist de seu aplicativo é incrementado automaticamente para cada compilação. A alteração ocorre antes da compilação e não será confirmada em seu repositório.

Observação

Para que o número de Build de incremento funcione, nomeie o .plist file como *Info.plist Production-Info.plist .

3.5. Testes

Se o esquema selecionado tiver uma ação de teste com um destino de teste selecionado, você poderá configurar os testes para serem executados como parte de cada compilação. Atualmente, App Center pode executar testes de unidade XCTest.

3.6. Assinatura de código

A criação de um aplicativo iOS para dispositivos reais requer a assinatura dele com credenciais válidas. Para assinar builds no App Center, habilita a assinatura de código no painel de configuração e carregue um perfil de provisionamento ( ) e um certificado .mobileprovision válido ( .p12 ), juntamente com a senha do certificado.

As configurações em seu projeto do Xcode devem ser compatíveis com os arquivos que você está carregando. Você pode ler mais sobre a assinatura de código na documentação oficial do Desenvolvedor da Apple.

Aplicativos com extensões de aplicativo ou watchOS exigem que um perfil de provisionamento adicional por extensão seja assinado.

3.7. Iniciar seu build bem-sucedido em um dispositivo real

Use o arquivo .ipa recém-produzido para testar se o aplicativo é iniciado em um dispositivo real. Iniciar em um dispositivo real adicionará aproximadamente mais 10 minutos ao tempo total de build. Leia mais sobre como configurar testes de lançamento.

3.8. CocoaPods

App Center verifica o branch selecionado e, se ele encontrar um Podfile, ele fará automaticamente uma etapa no início pod install de cada build. Esta etapa garantirá que todas as dependências sejam instaladas.

Aviso

Se o repositório já contiver uma pasta /Pods, você App Center que você fez check-in nos pods em seu repositório e não executará mais pod install . Se você remover ou modificar a pasta /Pods, talvez seja preciso salvar a configuração de Build manualmente usando ou para que a atualização Save entre em Save and Build vigor.

3.9. Distribuir para um grupo de distribuição

Você pode configurar cada build bem-sucedido de um branch para ser distribuído para um grupo de distribuição criado anteriormente. Você pode adicionar um novo grupo de distribuição de dentro da seção Distribuir. Sempre há um grupo de distribuição padrão chamado "Colaboradores" que inclui todos os usuários que têm acesso ao aplicativo.

Depois de salvar a configuração, uma nova compilação será iniciada automaticamente.

4. resultados da compilação

Depois que uma compilação é disparada, ela pode estar nos seguintes Estados:

  • na fila -a compilação é enfileirada aguardando a liberação dos recursos.
  • compilando -a compilação está executando as tarefas predefinidas.
  • êxito -a compilação foi concluída e foi bem-sucedida.
  • falha -a compilação foi concluída, mas falhou. Você pode solucionar o problema que deu errado inspecionando os logs de compilação.
  • cancelado -a compilação foi cancelada por uma ação do usuário ou atingiu o tempo limite

4.1. Logs de build

Para uma compilação concluída (com êxito ou falha), baixe os logs para entender mais sobre como a compilação foi feita. App Center fornece um arquivo morto com os seguintes arquivos:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1> (e.g. 2_Get Sources.txt)
    |-- <build-step-2> (e.g. 3_Pod install.txt)
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Os logs específicos da etapa de compilação (localizados no build/ diretório do arquivo) são úteis para solução de problemas e compreensão em qual etapa e por que a compilação falhou.

4.2. O aplicativo (. IPA)

O .ipa arquivo é um arquivo de aplicativo do dispositivo IOS que contém o aplicativo Ios.

  • Compilações não assinadas não produzirão um .ipa arquivo. O artefato de uma compilação não assinada é o .xcarchive arquivo que pode ser usado para gerar um .ipa arquivo com o organizador de arquivos do Xcode.
  • Se a compilação for assinada corretamente, o .ipa arquivo poderá ser instalado em um dispositivo real correspondente ao perfil de provisionamento usado durante a assinatura. Mais detalhes sobre a assinatura de código e a distribuição com App Center podem ser encontrados na documentação de assinatura de código do IOS do App Center.
  • Se a compilação não tiver sido assinada, o .ipa arquivo poderá ser assinado pelo desenvolvedor (por exemplo, localmente usando codesign) ou usado para outras finalidades (por exemplo, carregar no serviço de teste para teste de interface do usuário em dispositivos reais ou executar no simulador).

4.3. O arquivo de símbolos (. dsym)

Os .dsym arquivos contêm os símbolos de depuração para o aplicativo.

  • Se você tiver integrado anteriormente o SDK do App Center em seu aplicativo com o módulo de relatório de falhas habilitado, o serviço de relatório de falhas exigirá esse arquivo para que um build extiver relatórios de falha acessíveis .dsym (simbólicos) humanos.
  • Se você já integrou outro SDK para fins de relatório de falhas em seu aplicativo (por exemplo, O SDK do HockeyApp), o serviço correspondente exigirá que o arquivo exiba relatórios de falha que podem ser lidos por .dsym humanos.

Tenha em mente que os .dsym arquivos não são alterados após a assinatura de código do .ipa . Se você decidir assinar o build mais tarde, o gerado antes da assinatura .dsym de código ainda será válido.

Versões e requisitos com suporte

Os detalhes da versão do Xcode do computador de build são atualizados sempre que uma nova versão do Xcode é adicionada. Estamos atentos às versões mais recentes lançadas pela Apple e as incluímos assim que possível nas VMs usadas para executar os builds.