Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use essa tarefa para criar um workspace do Xcode no macOS.
Sintaxe
# Xcode Build v3
# Build an Xcode workspace on macOS.
- task: Xcode@3
inputs:
actions: 'build' # string. Required. Actions. Default: build.
#configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
#sdk: '$(SDK)' # string. SDK. Default: $(SDK).
#xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
#scheme: # string. Scheme.
#packageApp: true # boolean. Create App Package. Default: true.
# Package Options
#archivePath: # string. Archive Path.
#exportPath: 'output/$(SDK)/$(Configuration)' # string. Export Path. Default: output/$(SDK)/$(Configuration).
#exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Export Options. Default: auto.
#exportMethod: 'development' # string. Required when exportOptions == specify. Export Method. Default: development.
#exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID.
#exportOptionsPlist: # string. Required when exportOptions == plist. Export Options Plist.
#exportArgs: # string. Export Arguments.
# Signing & Provisioning
#xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
#teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID.
#signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
#iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity.
#unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
#defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password.
#provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID.
#p12: # string. Optional. Use when signMethod = file. P12 Certificate File.
#p12pwd: # string. Optional. Use when signMethod = file. P12 Password.
#provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File.
#removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
# Advanced
#args: # string. Arguments.
#cwd: # string. Working Directory.
outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
#xcodeDeveloperDir: # string. Xcode Developer Path.
#useXcpretty: false # boolean. Use xcpretty. Default: false.
#publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
Entradas
ações actions -
string. Obrigatório Valor padrão: build.
Especifica uma lista delimitada por espaço de ações. As opções válidas são build, clean, test, analyze e archive. Por exemplo: build clean executa um build limpo. Consulte o Apple: compilando a partir da linha de comando com perguntas frequentes do Xcode.
de Configuração do configuration -
string. Valor padrão: $(Configuration).
Especifica a configuração de projeto ou workspace do Xcode a ser compilada. Ao usar uma variável, especifique um valor (por exemplo, Release) na guia variáveis.
sdk
-
do SDK
string. Valor padrão: $(SDK).
Cria um projeto Xcode ou workspace no SDK especificado. Execute xcodebuild -showsdks para ver uma lista válida de SDKs.
xcWorkspacePath
-
workspace/ de caminho do projeto
string. Valor padrão: **/*.xcodeproj/*.xcworkspace.
Opcional. Especifica o caminho relativo da raiz do repositório para o workspace ou projeto do Xcode. Por exemplo: MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcworkspace/MyApp.xcodeproj. Deixe em branco se você pretende usar -target flag em Argumentos Avançados.
esquema scheme -
string.
Opcional. Especifica o nome do esquema Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Esquemas Gerenciados no Xcode). obrigatório se o Workspace for especificado.
packageApp
-
Criar pacote de aplicativos
boolean. Valor padrão: true.
Especifica se um IPA é gerado como parte do build. Para exportar arquivos com Xcode 7 e Xcode 8, examine as entradas adicionais na seção Opções de Pacote.
archivePath
-
de caminho de arquivamento
string.
Opcional. Especifica um diretório em que os arquivos criados são colocados.
exportPath
-
de caminho de exportação
string. Valor padrão: output/$(SDK)/$(Configuration).
Opcional. Especifica o destino do produto exportado do arquivo morto.
opções de exportação exportOptions -
string. Valores permitidos: auto, plist, specify. Valor padrão: auto.
Especifica uma maneira de passar Opções de Exportação ao exportar o arquivo morto.
método de exportação exportMethod -
string. Necessário quando exportOptions == specify. Valor padrão: development.
Especifica o método que o Xcode usa para exportar o arquivo morto. Por exemplo, app-store, package, ad-hoc, enterpriseou development.
exportTeamId
-
ID da equipe
string. Opcional. Use quando exportOptions == specify.
Especifica a ID da equipe de 10 dígitos do Portal do Desenvolvedor da Apple a ser usada para a exportação.
exportOptionsPlist
-
opções de exportação Plist
string. Necessário quando exportOptions == plist.
Especifica o caminho para um arquivo plist que configura a exportação de arquivos.
exportArgs
-
exportar argumentos
string.
Especifica argumentos de linha de comando adicionais usados para exportar.
xcode8AutomaticSigning
-
de Assinatura Automática
boolean. Valor padrão: false.
Use essa entrada se você tiver um projeto Xcode 8 ou Xcode 9 configurado para Assinatura Automática.
teamId
-
ID da equipe
string. Opcional. Use quando xcode8AutomaticSigning = true.
Especifica a ID da equipe de desenvolvedor de 10 dígitos. Isso será necessário se você for membro de várias equipes de desenvolvimento.
substituição de signMethod - usando
string. Valores permitidos: file (Conteúdo do Arquivo), id (Identificadores). Valor padrão: file.
Use essa entrada se o build usar um método de assinatura ou provisionamento diferente do padrão. Escolha File Contents para usar um certificado P12 e um perfil de provisionamento. Escolha Identifiers para recuperar as configurações de assinatura do conjunto de chaves padrão e dos perfis pré-instalados. Deixe os campos correspondentes em branco se você não quiser substituir as configurações de build padrão.
iosSigningIdentity
-
de identidade de assinatura
string. Opcional. Use quando signMethod = id.
Especifica a substituição de identidade de assinatura usada para assinar o build. O padrão é a configuração do projeto Xcode. desbloquear de conjunto de chaves padrão pode precisar ser selecionado.
unlockDefaultKeychain
-
desbloquear de conjunto de chaves padrão
boolean. Opcional. Use quando signMethod = id. Valor padrão: false.
Resolve A interação do usuário não é permitida erros desbloqueando o conjunto de chaves padrão.
defaultKeychainPassword
-
de senha de conjunto de chaves padrão
string. Opcional. Use quando signMethod = id.
Especifica a senha para desbloquear o conjunto de chaves padrão.
provProfileUuid
-
UUID do perfil de provisionamento
string. Opcional. Use quando signMethod = id.
Especifica a UUID de um perfil de provisionamento instalado a ser usado para o build. Use tarefas de build separadas com esquemas ou destinos diferentes para especificar perfis de provisionamento por destino em um único workspace (iOS, WatchKit, tvOS).
p12
-
de arquivo de certificado P12
string. Opcional. Use quando signMethod = file.
Especifica o caminho relativo para um arquivo de certificado P12 formatado PKCS12 que contém um certificado de assinatura a ser usado para o build.
p12pwd
-
de senha P12
string. Opcional. Use quando signMethod = file.
Especifica a senha para um arquivo de certificado P12. Use uma variável de build para criptografar.
provProfile
-
arquivo de perfil de provisionamento
string. Opcional. Use quando signMethod = file.
Especifica o caminho relativo para um arquivo que contém uma substituição de perfil de provisionamento a ser usada para o build. Use tarefas de build separadas com esquemas ou destinos diferentes para especificar perfis de provisionamento por destino em um único workspace (iOS, WatchKit, tvOS).
removeProfile
-
remover perfil após de build
boolean. Opcional. Use quando signMethod = file. Valor padrão: false.
Remove o conteúdo do arquivo de perfil de provisionamento do agente de build após a conclusão do build. Verifique somente se você está executando um agente por usuário.
argumentos args -
string.
Especifica argumentos de linha de comando adicionais usados para compilar. Essa entrada será útil se você quiser usar -target ou -project em vez de especificar um workspace e um esquema.
do Diretório de Trabalho do
string.
Especifica o diretório de trabalho para execuções de build. O padrão é a raiz do repositório.
outputPattern
-
do Diretório de Saída
string. Obrigatório Valor padrão: output/$(SDK)/$(Configuration).
Especifica o caminho relativo em que a saída de build (binários) é colocada.
xcodeDeveloperDir
-
de Caminho do Desenvolvedor do Xcode
string.
Opcional. Especifica o caminho para a pasta Desenvolvedor do Xcode se não for o padrão do sistema. Para uso quando várias versões do Xcode são instaladas em um sistema. Por exemplo: /Applications/Xcode 7.app/Contents/Developer.
useXcpretty
-
Usar xcpretty
boolean. Valor padrão: false.
Formata xcodebuild saída e gera um relatório de resultados de teste JUnit. Deve ser instalado em hosts de agente. Saiba mais sobre xcpretty.
publishJUnitResults
-
Publicar no VSTS/TFS
boolean. Valor padrão: false.
Os resultados do teste JUnit que foram produzidos usando xctool são publicados no VSTS/TFS.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, build clássico |
| Execuções em | Agent, DeploymentGroup |
| de demandas | Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: xcode |
| recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| restrições de comando | Qualquer |
| variáveis settable | Qualquer |
| Versão do agente | Todas as versões de agente com suporte. |
| Categoria de tarefa | Construir |