Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Use esta tarefa para criar um espaço de trabalho 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.
Insumos
actions
-
Ações
string. Obrigatório. Valor padrão: build.
Especifica uma lista de ações delimitada por espaço. As opções válidas são build, clean, test, analyzee archive. Por exemplo: build clean executa uma compilação limpa. Consulte o Apple: Construindo a partir da linha de comando com o Xcode FAQ.
configuration
-
de configuração
string. Valor padrão: $(Configuration).
Especifica o projeto Xcode ou a configuração do espaço de trabalho a ser compilado. Ao usar uma variável, especifique um valor (por exemplo, Release) na guia Variáveis.
sdk
-
SDK
string. Valor padrão: $(SDK).
Cria um projeto ou espaço de trabalho Xcode em relação ao SDK especificado. Execute xcodebuild -showsdks para ver uma lista válida de SDKs.
xcWorkspacePath
-
do espaço de trabalho/caminho do projeto
string. Valor padrão: **/*.xcodeproj/*.xcworkspace.
Opcional. Especifica o caminho relativo da raiz do repositório para o espaço de trabalho ou projeto 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.
scheme
-
Esquema
string.
Opcional. Especifica o nome do esquema Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Managed Schemes no Xcode). Obrigatório se o espaço de trabalho for especificado.
packageApp
-
Criar pacote de aplicativo
boolean. Valor padrão: true.
Especifica se um IPA é gerado como parte da compilação. Para exportar arquivos com Xcode 7 e Xcode 8, revise entradas adicionais na seção Opções de Pacote.
archivePath
-
de caminho de arquivo
string.
Opcional. Especifica um diretório onde os arquivos criados são colocados.
exportPath
-
Caminho de exportação
string. Valor padrão: output/$(SDK)/$(Configuration).
Opcional. Especifica o destino do produto exportado do arquivo.
exportOptions
-
Opções de exportação
string. Valores permitidos: auto, plist, specify. Valor padrão: auto.
Especifica uma maneira de passar Opções de Exportação ao exportar o arquivo.
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. Por exemplo, app-store, package, ad-hoc, enterpriseou development.
exportTeamId
-
ID da Equipa
string. Opcional. Use quando exportOptions == specify.
Especifica o ID de equipe de 10 dígitos do Apple Developer Portal a ser usado para a exportação.
exportOptionsPlist
-
Exportar Opções Plist
string. Necessário quando exportOptions == plist.
Especifica o caminho para um arquivo plist que configura a exportação de arquivos.
exportArgs
-
Argumentos de exportação
string.
Especifica argumentos de linha de comando adicionais usados para exportar.
xcode8AutomaticSigning
-
de assinatura automática
boolean. Valor padrão: false.
Use esta entrada se você tiver um projeto Xcode 8 ou Xcode 9 configurado para assinatura automática.
teamId
-
ID da Equipa
string. Opcional. Use quando xcode8AutomaticSigning = true.
Especifica o ID da equipe de desenvolvedores de 10 dígitos. Isso é necessário se você for membro de várias equipes de desenvolvimento.
signMethod
-
Substituir usando
string. Valores permitidos: file (Conteúdo do arquivo), id (Identificadores). Valor padrão: file.
Use essa entrada se a compilação usar um método de assinatura ou provisionamento diferente do padrão. Escolha File Contents usar um certificado P12 e um perfil de provisionamento. Escolha Identifiers para recuperar as configurações de assinatura das chaves padrão e dos perfis pré-instalados. Deixe os campos correspondentes em branco se não desejar substituir as configurações de compilação padrão.
iosSigningIdentity
-
de identidade de assinatura
string. Opcional. Use quando signMethod = id.
Especifica a substituição de identidade de assinatura usada para assinar a compilação. O padrão é a configuração do projeto Xcode. Desbloquear Porta-chaves Padrão pode precisar ser selecionada.
unlockDefaultKeychain
-
Desbloquear Porta-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 as chaves padrão.
defaultKeychainPassword
-
Palavra-passe predefinida do porta-chaves
string. Opcional. Use quando signMethod = id.
Especifica a senha para desbloquear as chaves padrão.
provProfileUuid
-
Perfil de provisionamento UUID
string. Opcional. Use quando signMethod = id.
Especifica o UUID de um perfil de provisionamento instalado a ser usado para a compilação. Use tarefas de compilação separadas com esquemas ou destinos diferentes para especificar perfis de provisionamento por destino em um único espaço de trabalho (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 a compilação.
p12pwd
-
Senha P12
string. Opcional. Use quando signMethod = file.
Especifica a senha para um arquivo de certificado P12. Use uma variável de compilação 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 a compilação. Use tarefas de compilação separadas com esquemas ou destinos diferentes para especificar perfis de provisionamento por destino em um único espaço de trabalho (iOS, WatchKit, tvOS).
removeProfile
-
Remover perfil após a compilação
boolean. Opcional. Use quando signMethod = file. Valor padrão: false.
Remove o conteúdo do arquivo de perfil de provisionamento do agente de compilação após a conclusão da compilação. Verifique apenas se você está executando um agente por usuário.
args
-
Argumentos
string.
Especifica argumentos de linha de comando adicionais usados para compilar. Essa entrada é útil se você quiser usar -target ou -project em vez de especificar um espaço de trabalho e um esquema.
cwd
-
Diretório de Trabalho
string.
Especifica o diretório de trabalho para execuções de compilação. O padrão é a raiz do repositório.
outputPattern
-
Diretório de saída
string. Obrigatório. Valor padrão: output/$(SDK)/$(Configuration).
Especifica o caminho relativo onde a saída de compilação (binários) é colocada.
xcodeDeveloperDir
-
do caminho do desenvolvedor do Xcode
string.
Opcional. Especifica o caminho para a pasta Xcode Developer 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
-
Use 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 controlo de tarefas
Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Requerimentos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, construção clássica |
| Funciona em | Agente, DeploymentGroup |
| Exigências | Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: xcode |
| Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho. |
| Restrições de comando | Qualquer |
| Variáveis configuráveis | Qualquer |
| Versão do agente | Todas as versões de agente suportadas. |
| Categoria de tarefa | Construir |