Comando Check-in

  • Artigo

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

Visual Studio 2019 | Visual Studio 2022

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

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

Sugestões

  • Para separar alterações ou limpar seu espaço de trabalho 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 máquina e uma conta de usuário não tiverem um espaço de trabalho mapeado para a coleção de projetos que contém o conjunto de prateleiras, você poderá usar as /shelveset opções e /collection para fazer check-in de 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 das alterações em nome de outro usuário.

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

/bypass

Ignora um requisito de check-in fechado. Para obter mais informações, consulte Check-in em uma pasta controlada por um processo de compilação de check-in fechado.

/collection:<ProjectCollectionUrl>

Se você usar a shelveset opção, a /collection opção 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 espaço de trabalho 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 para o 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 para fazer check-in no espaço de trabalho do usuário. Você pode especificar mais de um itemspec argumento. 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 notas de check-in e a política de check-in substituem o motivo são armazenados em sua máquina de desenvolvimento como alterações pendentes até que você faça check-in. A /new opção limpa esses metadados de check-in antes do check-in. Essa opção e o comportamento que ela modifica não têm efeito quando você usa a /noprompt opção.

/noautoresolve

Por padrão, o sistema tenta AutoResolve All automaticamente conflitos. 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 notas de check-in para associar ao conjunto de alterações usando um dos seguintes argumentos:

  • <NoteFieldName>=<NoteFieldValue>: Define o valor do campo de nota de check-in. Você pode fornecer várias expressões separadas por field=value 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 nota de check-in no formato de field=value. Um bloco de anotações 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 pelo qual a política de check-in está 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 os itens no diretório especificado e em quaisquer subdiretórios.

/saved

Ignore este parâmetro.

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

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

Nota

Depois de fazer check-in na prateleira, o sistema a exclui.

/validate

Testa se o check-in seria bem-sucedido, sem fazer check-in dos arquivos. O sistema avalia políticas de check-in, notas de check-in e lista conflitos.

Nota

Se você não especificar a /noprompt opção, 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 verifica os arquivos.

Exemplos

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

Fazer check-in de todas as alterações pendentes no espaço de trabalho atual

O comando a seguir exibe a caixa de diálogo Check-in , que exibe todas as alterações pendentes no espaço de trabalho 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 executar outras tarefas e, em seguida, escolher o botão Check-in quando estiver pronto para continuar.

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 espaço de trabalho atual e fornece um comentário para ajudar seus colegas de equipe a entender o propósito 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 algum conflito bloquear o check-in, o sistema não exibirá a janela de conflitos.

c:\code\SiteApp\Main>tf checkin program.cs /noprompt