Compartilhar via

Comando Checkin

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

O comando checkin TFVC verifica as alterações de arquivo e pasta pendentes no servidor.

Quase todas as alterações feitas nos arquivos em seu computador de desenvolvimento são armazenadas em seu workspace como um alteração pendente até que você faça check-in. Quando você faz check-in das alterações, elas são armazenadas como um conjunto de alterações no servidor. O comando checkin fornece uma interface do usuário diferente para fazer os mesmos processos documentados para o Visual Studio no Fazer check-in do seu trabalho para a base de código da equipe.

Dicas

  • Para deixar de lado as alterações ou limpar o workspace para outra tarefa, use o comando Shelve.

  • Se os conflitos bloquearem o check-in, você poderá usar o comando resolver para resolvê-los.

  • Se uma conta de computador e de usuário não tiver um workspace mapeado para a coleção de projetos que contém o conjunto de prateleiras, você poderá usar as opções /shelveset e /collection para fazer check-in em um conjunto de prateleiras.

Pré-requisitos

Sintaxe

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:("Note Name"="note text"|@notefile)] 
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve] [/login:username,[password]] [/new]

tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

Parâmetros

Parâmetro

Descrição

/author:<author name>

Identifica o autor das alterações pendentes para que um usuário possa fazer check-in de alterações em nome de outro usuário.

Requer a permissão CheckinOther. Consulte de referência de permissões e grupos de.

/bypass

Ignora um requisito de check-in fechado. Para obter mais informações, consulte Fazer check-in em uma pasta controlada por um processo de build de check-in restrito.

/collection:<ProjectCollectionUrl>

Se você usar a opção shelveset, a opção /collection especifica a URL da coleção de projetos que contém o conjunto de prateleiras. Por exemplo: http://myserver:8080/tfs/DefaultCollection.

Por padrão, presume-se que a coleção de projetos seja aquela que contém o workspace que mapeia o diretório atual.

/comment

Associa um comentário ao conjunto de alterações usando um dos seguintes argumentos:

  • "<comment>": um comentário fornecido pelo usuário sobre o check-in.
  • @<comment file>: o caminho para um arquivo no disco que contém o comentário do check-in.

/force

Força um check-in em itens com edições pendentes mesmo quando não há alterações de conteúdo no arquivo.

<itemspec>

Especifica o escopo dos itens a serem verificados no workspace do usuário. Você pode especificar mais de um argumento itemspec. Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation.

/login:<username>[,<password>]

Especifica a conta de usuário para executar o comando. Consulte Usar comandos de controle de versão do Team Foundation.

/new

O estado selecionado de cada alteração pendente, conforme mostrado na caixa de diálogo Check-In. O comentário, os itens de trabalho associados, as anotações de check-in e o motivo da substituição da política de check-in são armazenados no computador de desenvolvimento como alterações pendentes até que você os faça check-in. A opção /new limpa esses metadados de check-in antes de fazer check-in. Essa opção e o comportamento modificados não têm efeito quando você usa a opção /noprompt.

/noautoresolve

Por padrão, o sistema tenta AutoResolve All conflitos automaticamente. Especifique essa opção para desabilitar esse comportamento padrão. Para obter mais informações, consulte Resolver conflitos de controle de versão do Team Foundation.

/noprompt

Suprime a exibição de janelas e caixas de diálogo, como a caixa de diálogo Check-In e redireciona os dados de saída para o prompt de comando. Consulte Usar comandos de controle de versão do Team Foundation.

/notes

Fornece uma ou mais anotações de check-in para associar ao conjunto de alterações usando um dos seguintes argumentos:

  • <NoteFieldName>=<NoteFieldValue>: define o valor do campo de anotação de check-in. Você pode fornecer várias expressões field=value separadas por ponto-e-vírgula.
  • @<NoteFile>: o caminho fornecido pelo usuário de um arquivo no disco que contém nomes e valores de campo de anotação de check-in no formato de field=value. Um bloco de anotação separado por ponto-e-vírgula pode abranger várias linhas, por exemplo:

    <Field1>=<Value1>;
    <Field2>=<First line of Value2>;
    <Second line of Value2>;
    <Field3>=<Value3>;

/override

Substitui uma política de check-in usando um dos seguintes argumentos:

  • reason: um motivo fornecido pelo usuário para que a política de check-in esteja sendo ignorada.
  • reasonfile: o caminho para um arquivo que contém uma descrição fornecida pelo usuário do motivo pelo qual a política de check-in está sendo ignorada.

/recursive

Verifica recursivamente em itens no diretório especificado e em quaisquer subdiretórios.

/saved

Ignore esse parâmetro.

/shelveset:<shelvesetname>[;<owner>]

Especifica um conjunto de prateleiras para fazer check-in. O argumento owner opcional especifica um conjunto de prateleiras que o usuário atual não possui.

Observação

Depois de fazer check-in no conjunto de prateleiras, o sistema o excluirá.

/validate

Testa se o check-in teria êxito, sem fazer check-in nos arquivos. O sistema avalia políticas de check-in, anotações de check-in e listas de conflitos.

Observação

Se você não especificar a opção /noprompt, deverá selecionar o botão Check-In na caixa de diálogo Check-In para validar o check-in. Depois de selecionar esse botão, o sistema não faz check-in nos arquivos.

Exemplos

Os exemplos a seguir pressupõem que c:\code\SiteApp\Main é a pasta principal mapeada para a coleção de projetos no workspace do usuário.

Fazer check-in de todas as alterações pendentes no workspace atual

O comando a seguir exibe a caixa de diálogo Check-In, que exibe todas as alterações pendentes no workspace atual. Você pode usar a caixa de diálogo Check-In para selecionar ou desmarcar as alterações pendentes que deseja fazer check-in, adicionar um comentário, associar itens de trabalho e realizar outras tarefas e, em seguida, escolher o botão Check-In quando estiver pronto para prosseguir.

c:\code\SiteApp\Main>tf checkin

Fazer check-in de todas as alterações pendentes com um comentário

O exemplo a seguir verifica todas as alterações pendentes no workspace atual e fornece um comentário para ajudar seus colegas a entender a finalidade das alterações.

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

Fazer check-in de uma alteração em um único item sem usar a caixa de diálogo Check-In

O exemplo a seguir verifica as alterações pendentes no program.cs. A caixa de diálogo Check-In não é exibida e, se conflitos bloquearem o check-in, o sistema não exibirá a janela de conflitos.

c:\code\SiteApp\Main>tf checkin program.cs /noprompt
  • Last updated on