Início rápido: compartilhar seu primeiro projetoQuickstart: Share your first project

Bem-vindo ao Visual Studio Live Share!Welcome to Visual Studio Live Share! O Live Share permite que você edite e depure de forma colaborativa com outras pessoas em tempo real, sejam quais forem as linguagens de programação usadas ou os tipos de aplicativo criados.Live Share enables you to collaboratively edit and debug with others in real time, regardless what programming languages you're using or app types you're building. Ele permite que você compartilhe seu projeto atual de forma instantânea e segura e, em seguida, conforme necessário, compartilhe sessões de depuração, instâncias de terminal, aplicativos Web do localhost, chamadas de voz e muito mais!It allows you to instantly and securely share your current project, and then as needed, share debugging sessions, terminal instances, localhost web apps, voice calls, and more!

Pronto para começar?Ready to get going? A colaboração em equipe será tão rápida e natural que será difícil não participar.Team collaboration should be so quick and natural, that it becomes harder not to do it! Por esse motivo, o Visual Studio Live Share simplifica o início, para que você possa começar a compartilhar seu trabalho e suas ideias facilmente.For this reason, Visual Studio Live Share makes it simple to get started, so that you can seamlessly begin sharing your work and ideas.

Dica

Você sabia que pode ingressar em sua própria sessão de colaboração?Did you know you can join your own collaboration session? Isso permite que você experimente o Live Share por conta própria ou crie uma instância do Visual Studio ou do VS Code e conecte-a remotamente.This allows you to try Live Share on your own or to spin up an instance of Visual Studio or VS Code and connect to it remotely! Você pode até mesmo usar a mesma identidade em ambas as instâncias.You can even use the same identity in both instances. Confira!Check it out!

Basta seguir estas etapas para iniciar o compartilhamento.Just follow these steps to start sharing.

1. instalar a extensão1. Install the extension

É fácil instalar a extensão.Installing the extension is easy. Basta seguir estas etapas:Just follow these steps:

Visual Studio Code logo Visual Studio Code (1.22.0 ou posterior) Visual Studio Code (1.22.0+)
1. Instale o Visual Studio Code para Windows (7, 8.1 ou 10), macOS (Serra ou posterior) e Linux de 64 bits (detalhes) 1. Install Visual Studio Code for Windows (7, 8.1, or 10), macOS (Sierra+), 64-bit Linux (details)
2. Baixe e instale a extensão do Visual Studio Live Share por meio do marketplace. 2. Download and install the Visual Studio Live Share extension from the marketplace.
3. Recarregue-a e aguarde até as dependências serem baixadas e instaladas (veja a barra de status). 3. Reload and wait for dependencies to download and install (see status bar).
4. Linux: se for solicitado a instalar bibliotecas, clique em instalar, digite a senha, reinicie vs Code quando terminar. 4. Linux: If prompted to install libraries, click install, enter password, restart VS Code when done.
Download button
Visual Studio 2019 logo Visual Studio 2019 Visual Studio 2019
1.Instale o Visual Studio 2019. 1. Install Visual Studio 2019.
2. Instale uma carga de trabalho compatível. 2. Install a supported workload. (por exemplo, ASP.NET, .NET Core, C++, Python e/ou Node.js)(e.g. ASP.NET, .NET Core, C++, Python, and/or Node.js)
3. O Visual Studio Live Share é instalado por padrão com essas cargas de trabalho. 3. Visual Studio Live Share is installed by default with these workloads.
Visual Studio 2017 logo Visual Studio 2017 15.6 ou posterior Visual Studio 2017 15.6 or higher
1. Instale a última versão do Visual Studio 2017 (15.6 ou posterior) no Windows (7, 8.1 ou 10). 1. Install the latest version of Visual Studio 2017 (15.6+) on Windows (7, 8.1, or 10).
2. Instale uma carga de trabalho compatível. 2. Install a supported workload. (por exemplo, ASP.NET, .NET Core, C++ e/ou Node.js)(e.g. ASP.NET, .NET Core, C++, and/or Node.js)
3. Baixe e instale a extensão do Visual Studio Live Share por meio do marketplace. 3. Download and install the Visual Studio Live Share extension from the marketplace.
Download button

Ao baixar e usar o Visual Studio Live Share, você concorda com os termos de licença e a política de privacidade.By downloading and using Visual Studio Live Share, you agree to the license terms and privacy statement. Confira Solução de problemas caso tenha problemas.See troubleshooting if you run into problems.

2. entrar2. Sign in

Após instalar a extensão do Live Share, reiniciar e aguardar as dependências terminarem a instalação (VS Code), entre para que os outros participantes conheçam você.After installing the Live Share extension, restarting, and waiting for dependencies to finish installing (VS Code), you'll want to sign in to let other participants know who you are. Clique no item da barra de status "Live Share" (VS Code)/no botão "Entrar" (VS) para começar.Simply click the "Live Share" status bar item (VS Code) / "Sign in" button (VS) to get started.

Visual Studio Code sign in status bar item Visual Studio sign in button

No VS Code, seu navegador será iniciado e uma notificação será exibida, solicitando que você entre.In VS Code, your browser will launch while a notification will appear launch asking you to sign in. Conclua o processo de entrada no navegador e, em seguida, feche-o quando terminar.Complete the sign in process in your browser, then simply close the browser when done.

Notificação do sistema solicitando a entrada com um navegador da Web

Usuários do Linux: Você pode ser solicitado a inserir um código de usuário se estiver usando uma versão mais antiga do Live Share (v 0.3.295 ou inferior).Linux users: You may be prompted to enter a user code if you are using an older version of Live Share (v0.3.295 or below). Atualize para a versão mais recente da extensão ou clique no link "Está com problemas?"Update to the latest version of the extension or click the "Having trouble?" depois de entrar para ver o código.link after sign in to see the code. Consulte aqui para obter detalhes.See here for details.

No Visual Studio, o Live Share usa automaticamente sua conta de personalização.In Visual Studio, Live Share automatically uses your personalization account. Como resultado, você pode simplesmente entrar como você faria normalmente.As a result, you can simply sign in as you would normally. No entanto, se você preferir usar um logon diferente da sua conta de personalização do Visual Studio, acesse Ferramentas > Opções > Live Share > Conta de usuário e selecione credenciais diferentes.However, if you prefer to use a different sign-in than your Visual Studio personalization account, go to Tools > Options > Live Share > User account and select different credentials.

Confira Solução de problemas se ainda tiver problemas.See troubleshooting if you are still hitting problems.

3. abrir uma pasta, um projeto ou uma solução3. Open a folder, project, or solution

Use o fluxo de trabalho normal para abrir uma pasta, um projeto ou uma solução que você queira compartilhar no Visual Studio ou no Visual Studio Code.Use your normal workflow to open a folder, project, or solution that you would like to share in Visual Studio or Visual Studio Code.

4. [Opcional] Atualize os arquivos ocultos ou excluídos4. [Optional] Update hidden or excluded files

Por padrão, o Live Share oculta dos convidados quaisquer arquivos/pastas referenciados nos arquivos .gitignore em suas pastas compartilhadas.By default, Live Share hides any files/folders referenced in .gitignore files in your shared folders from guests. Ocultar um arquivo impede que ele apareça na árvore de arquivos do convidado.Hiding a file prevents it from appearing in the guest's file tree. Excluir um arquivo aplica uma regra mais rigorosa que impede o Live Share de abri-lo para o convidado em situações como "Ir para Definição" ou se você intervir no arquivo durante a depuração ou ao ser "seguido".Excluding a file applies a stricter rule that prevents Live Share from opening it for the guest in situations like go to definition or if you step into the file while debugging or being "followed". Se você quiser ocultar/excluir arquivos diferentes, um arquivo .vsls.json poderá ser adicionado ao seu projeto com essas configurações.If you want to hide/exclude different files, a .vsls.json file can be added to your project with these settings. Confira Controlar o acesso a arquivos e visibilidade para saber mais detalhes.See controlling file access and visibility for details.

5. iniciar uma sessão de colaboração5. Start a collaboration session

Em seguida, basta clicar em "Live Share" na ferramenta e um link de convite será copiado automaticamente para sua área de transferência.Next, simply click "Live Share" within your tool and an invite link is automatically copied to your clipboard.

Visual Studio Code share status bar item Visual Studio share button

Observação

Talvez o software de firewall do computador exija que o agente do Live Share tenha permissão para abrir uma porta no primeiro compartilhamento.You may be asked by your desktop firewall software to allow the Live Share agent to open a port the first time you share. Aceitar isso é totalmente opcional, mas habilita um "modo direto" seguro para melhorar o desempenho quando a pessoa com que você está trabalhando estiver na mesma rede que você.Accepting this is entirely optional but enables a secured "direct mode" to improve performance when the person you are working with is on the same network as you are. Confira Alterar o modo de conexão para saber mais detalhes.See change the connection mode for details.

6. [Opcional] Habilite o modo somente leitura6. [Optional] Enable read-only mode

Após iniciar a sessão de colaboração, configure a sessão como somente leitura para impedir que os convidados façam edições no código compartilhado.Once you start your collaboration session, you can set the session to be read-only to prevent guests from making edits to the code being shared.

Após o compartilhamento, você receberá uma notificação de que o link de convite foi copiado para a área de transferência.After sharing, you will get a notification that the invite link has been copied to your clipboard. Em seguida, você poderá selecionar a opção para definir a sessão como somente leitura.You can then select the option to make the session read-only.

Visual Studio Code read-only option Visual Studio read-only option

No VS Code, você também pode iniciar uma sessão somente leitura na guia de viewlet do Live Share.In VS Code, you can also start a read-only session from the Live Share viewlet tab.

Notificação do sistema solicitando a entrada com um navegador da Web

Envie o link por email, pelo Slack, pelo Skype etc. para as pessoas que você quer convidar.Send the link over e-mail, Slack, Skype, etc. to those you want to invite. Abrir o link em um navegador permite que elas ingressem na sessão de colaboração que está compartilhando o conteúdo da pasta, do projeto ou da solução que você abriu.Opening the link in a browser allows them to join the collaboration session that is sharing the contents of the folder, project, or solution that you opened. Observe que, considerando o nível de acesso que as sessões do Live Share podem conceder aos convidados, você só deve compartilhar com pessoas em que confia e considerar as implicações do que você está compartilhando.Note that, given the level of access Live Share sessions can provide to guests, you should only share with people you trust and think through the implications of what you are sharing.

Dica de segurança: Quer entender as implicações de segurança de alguns dos recursos de Live Share?Security Tip: Want to understand the security implications of some of Live Share's features? Confira o artigo sobre segurança.Check out the security article.

Se o convidado que você convidou tiver dúvidas, o artigo início rápido: ingressar em sua primeira sessão fornecerá mais informações sobre como entrar em funcionamento como convidado.If the guest you invited has questions, the Quickstart: Join your first session article provides some more information on getting up and running as a guest.

8. [Opcional] Aprove o convidado8. [Optional] Approve the guest

Por padrão, os convidados ingressam automaticamente na sessão de colaboração e você recebe uma notificação quando eles estiverem prontos para trabalhar com você.By default, guests automatically join your collaboration session and you are notified when they're ready to work with you.

Visual Studio Code join notification Visual Studio join notification

Em vez disso, você pode optar por exigir uma "aprovação" explícita para todos que solicitarem ingresso.You can opt to require an explicit "approval" for anyone joining instead. Se essa configuração estiver ativada, uma notificação solicitará que você aprove o convidado quando este tentar ingressar em sua sessão.If you have this setting turned on, a notification prompts you to approve the guest when they try to join your session.

Confira Exigir aprovação do convidado para saber mais detalhes sobre como ativar esse recurso.See requiring guest approval for details on how to turn this feature on.

9. colabore!9. Collaborate!

É isso!That's it! Algumas coisas para experimentar quando um convidado ingressar:Here are a few things to try out once a guest has joined you:

  1. Navegue pelos diferentes arquivos do projeto de maneira independente e faça algumas ediçõesMove around to different files in the project independently and make some edits
  2. Siga o convidado e observe como ele navega, faz edições e acessa diferentes arquivosFollow the guest and observe as they scroll, make edits, and navigate to different files
  3. Inicie uma sessão de codepuração com o convidadoStart up a co-debugging session with them
  4. Compartilhe um servidor para conferir algo como um aplicativo Web em execução no computadorShare a server so you can check out something like a web app running on their machine
  5. Compartilhe um terminal e execute alguns comandosShare a terminal and run some commands

Confira a documentação de extensão do Visual Studio Code e do Visual Studio para saber como realizar essas ações e muito mais.Check out the Visual Studio Code and Visual Studio extension docs for information on how to do these actions and more.

Está tendo problemas?Having problems? Confira Solução de problemas ou envie comentários.See troubleshooting or provide feedback.

Próximas etapasNext Steps

Confira estes outros artigos para saber mais.Check out these additional articles for more information.

ReferênciaReference