Como: Compartilhar finalizações da equipe no Visual Studio IntelliCodeHow to: Share team completions in Visual Studio IntelliCode

A IntelliCode possui recursos de compartilhamento de finalizações de equipe que permitem compartilhar qualquer modelo que você criou e atualizar automaticamente os usuários que têm acesso quando você retreina o modelo.IntelliCode has team completions sharing features that let you share any model you've created and automatically update users that have access when you retrain the model.

Ao criar um modelo de conclusão de equipe, você recebe recomendações de conclusão da IntelliCode para código que não está no modelo base.By creating a team completions model, you get IntelliCode completion recommendations for code that's not in the base model. Compartilhar um modelo de conclusão de equipe com colaboradores estende as recomendações aprimoradas do IntelliSense a todos; eles não têm que criar ou retreinar um modelo de conclusão eles mesmos.Sharing a team completions model with collaborators extends the enhanced IntelliSense recommendations to everyone; they don't have to create or retrain a completions model themselves.

Compartilhe um modelo de conclusão de equipe associada ao repositórioShare a repository-associated team completions model

Os modelos associados ao repositório são compartilhados automaticamente com outros que trabalham na mesma base de código, desde que os usuários tenham permitido a aquisição automática de modelos de equipe no Visual Studio.Repository-associated models are automatically shared with others working in the same codebase as long as users have enabled automatic acquisition of team models in Visual Studio.

Habilite a aquisição automática indo para ferramentas > opções > IntelliCode > Adquirir modelos de equipe para conclusão.Enable automatic acquisition by going to Tools > Options > IntelliCode > Acquire team models for completion.

Quando alguém clona e abre a base de código em que o modelo foi treinado, quaisquer modelos de conclusão associados aos repositórios remotos Git configurados serão baixados e ativados.When anyone clones and opens the codebase the model was trained on, any completions models associated with the configured Git remote repositories will be downloaded and activated. Se você estiver trabalhando em um garfo da base de código, basta adicionar a base de código upstream como um repositório remoto para obter o modelo de conclusão.If you are working on a fork of the codebase, simply add the upstream codebase as a remote repository to get the completions model.

O acesso ao repositório é o acesso ao modelo.Access to the repository is access to the model. Ao treinar, coletamos algumas informações sobre o compromisso de check-out.When training, we collect some information about the checked-out commit. Quem solicitar esse modelo deve ter o mesmo compromisso em seu repositório e ser capaz de produzir as mesmas informações que foram coletadas durante o treinamento para receber o modelo da equipe.Anyone who requests that model must have the same commit in their repository and be able to produce the same information that was collected during training in order to receive the team model.

Você também pode compartilhar seu modelo indo para exibir > outros gerenciamentos > de modelos do WindowsIntelliCode, selecionando seu modelo no painel esquerdo e apertando o botão Compartilhar.You can also share your model by going to View > Other Windows > IntelliCode Model Management, selecting your model from the left pane, and hitting the Share button. Isso gera um link de compartilhamento que você pode enviar para qualquer um com quem você gostaria de compartilhar o modelo.This generates a sharing link you can send to anyone you'd like to share the model with.

Compartilhe um modelo de equipe associado ao usuárioShare a user-associated team model

Depois de treinar um modelo, o botão Compartilhar modelo será exibido.After you've trained a model, the Share model button appears. Clique no botão para copiar o link de compartilhamento.Click the button to copy the sharing link. Deste ponto em diante, você poderá compartilhar o link com seus colaboradores.From there, you can share the link with your collaborators.

Observação

Qualquer pessoa que tenha o link de compartilhamento pode acessar o modelo e suas sugestões, portanto, certifique-se de que qualquer pessoa que receba o link esteja ciente disso.Anyone who has the sharing link can access the model and its suggestions, so make sure that everyone who receives the link is aware of this.

Você pode compartilhar seu modelo com quantas pessoas quiser usando o recurso de compartilhamento.You can share your model with as many people as you like via the sharing feature. Os membros da equipe não podem treinar novamente o modelo, mas eles conseguem ver as mesmas recomendações de conclusão que você.Team members can't retrain the model but they do see the same completion recommendations as you do.

Adicionar um modelo de conclusão de equipe associada ao usuárioAdd a user-associated team completions model

Para usar um link de modelo que alguém compartilhou com você, execute estas etapas:To use a model link that someone shared with you, follow these steps:

  1. (Opcional) Se você estiver usando uma versão do Visual Studio anterior ao Visual Studio 2019 versão 16.1, primeiro instale a extensão do IntelliCode.(Optional) If you're using a version of Visual Studio prior to Visual Studio 2019 version 16.1, first install the IntelliCode extension.

  2. Abra a página IntelliCode escolhendo Exibir outro > gerenciamento de modelo doWindows > IntelliCode.Open the IntelliCode page by choosing View > Other Windows > IntelliCode Model Management.

  3. Na página do IntelliCode, escolha Adicionar modelo.On the IntelliCode page, choose Add model. Essa opção fica embaixo de Compartilhados Comigo na navegação à esquerda.It's underneath Shared With Me in the left-hand navigation.

    Adicione o modelo do IntelliCode no Visual Studio

  4. Cole a URL do link de compartilhamento na caixa de diálogo e escolha Adicionar.Paste the sharing link URL into the dialog box and choose Add.

    Adicione o modelo compartilhado no IntelliCode

    O modelo compartilhado aparece sob Compartilhado Comigo.The shared model appears under Shared With Me. Se deseja desvincular o modelo, escolha Desvincular.If you want to unlink the model, choose Unlink.

Cenários comuns de compartilhamentoCommon sharing scenarios

Esta seção descreve como configurar o compartilhamento de modelo para alguns casos comuns.This section describes how to set up model sharing for some common cases.

Projeto Open Source (baseado em git)Open Source project (git-based)

Suponha que você tenha uma base de código que contém bons padrões para usar os tipos contidos em uma biblioteca compartilhada.Suppose you have an existing codebase that contains good patterns for using types contained in a shared library. Você deseja que o IntelliCode aprenda com o uso em uma base de código para estimular você e seus colaboradores ao começar a trabalhar em seu próximo projeto que usa a mesma biblioteca.You'd like IntelliCode to learn from usage in that codebase to kickstart you and your collaborators when you start work on your next project that uses the same library. O novo projeto, por ser novo, não tem nenhum uso do qual aprender.The new project, being new, has no usage to learn from. Então, o que você faz?So what do you do?

A melhor solução é:The best approach here is:

  1. Treine um modelo para conclusão de equipe na base de código existente.Train a model for team completions on the existing codebase.

  2. Informe seus colegas de equipe para permitir a aquisição automática indo para ferramentas > opções > IntelliCode > adquirir modelos de equipe para conclusão no Visual Studio 2019 versão 16.1 ou posterior.Inform your teammates to enable automatic acquisition by going to Tools > Options > IntelliCode > Acquire team models for completion in Visual Studio 2019 version 16.1 or later.

Quando alguém clona e abre a base de código em que o modelo foi treinado, quaisquer modelos de conclusão associados aos repositórios remotos Git configurados serão baixados e ativados.When anyone clones and opens the codebase the model was trained on, any completions models associated with the configured Git remote repositories will be downloaded and activated. Se você estiver trabalhando em um garfo da base de código, basta adicionar a base de código upstream como um repositório remoto para obter o modelo de conclusão.If you are working on a fork of the codebase, simply add the upstream codebase as a remote repository to get the completions model.

O acesso ao repositório é o acesso ao modelo.Access to the repository is access to the model. Ao treinar, coletamos algumas informações sobre o compromisso de check-out.When training, we collect some information about the checked-out commit. Quem solicitar esse modelo deve ter o mesmo compromisso em seu repositório e ser capaz de produzir as mesmas informações que foram coletadas durante o treinamento para receber o modelo da equipe.Anyone who requests that model must have the same commit in their repository and be able to produce the same information that was collected during training in order to receive the team model.

  1. Automatize o retreinamento do seu modelo com a tarefa Azure Pipelines IntelliCode para manter as conclusões atualizadas com alterações de código.Automate retraining your model with the Azure Pipelines IntelliCode task to keep completions up-to-date with code changes. Sua equipe recebe automaticamente atualizações sempre que o repo é treinado.Your team automatically gets updates whenever the repo is trained.

Outros cenários de compartilhamentoOther sharing scenarios

Se houver outros cenários de compartilhamento que você achar que são importantes, queremos ouvir sobre eles.If there are other sharing scenarios you feel are important, we want to hear about them. Se estiver usando o Visual Studio, você poderá sugerir um recurso na comunidade de desenvolvedores.If you're using Visual Studio, you can suggest a feature on Developer Community. Se você estiver usando o Visual Studio Code, use o botão Enviar feedback sobre > esta página na parte inferior desta página.If you're using Visual Studio Code, use the Send feedback about > This page button at the bottom of this page.

Confira tambémSee also