Detalhes de Instalação do LinuxLinux installation details

Linux é um ambiente altamente variável e, com o grande número de ambientes de desktop e distribuições, pode ser complicado trabalhar.Linux is a highly variable environment and with the sheer number of desktop environments and distributions can be complicated to get working. Se você tiver as versões com suporte do Ubuntu Desktop (16.04 +), CentOS 7ou Fedora Workstation (27 +) e usar somente as distribuições oficiais do vs Code, você deverá encontrar o processo diretamente em frente.If you stick to supported versions of Ubuntu Desktop (16.04+), CentOS 7, or Fedora Workstation (27+) and only use official distributions of VS Code, you should find the process straight forward. No entanto, se estiver usando uma configuração não padrão ou distribuição downstream, pode ser que você passe por alguns contratempos.However, in the event that you are using a non-standard configuration or downstream distribution, you may or may not run into some hiccups. Este documento fornece algumas informações sobre os requisitos e alguns detalhes de solução de problemas que podem ajudá-lo a entrar em funcionamento mesmo que sua configuração seja apenas compatível com a Comunidade.This document provides some information on requirements and some troubleshooting details that might help you get up and running even if your configuration is only community supported. Observe que Live Share só dá suporte ao Linux de 64 bits.Note that Live Share only supports 64-bit Linux.

Instalar pré-requisitos do LinuxInstall Linux prerequisites

Algumas distribuições do Linux têm bibliotecas que o Live Share precisa para funcionar.Some distributions of Linux are missing libraries Live Share needs to function. Por padrão, o Live Share tenta detectar e instalar os pré-requisitos do Linux para você.By default, Live Share attempts to detect and install Linux prerequisites for you. Uma notificação será exibida quando o Live Share encontrar um problema que tenha sido originado pela ausência das bibliotecas, solicitando a você permissão para instalá-las.You'll see a toast notification when Live Share encounters a problem that can originate from missing libraries asking you for permission to install them.

Notificação do sistema mostrando a mensagem de que os pré-requisitos do Linux estão ausentes

Quando você clicar em "instalar", uma janela do terminal será exibida onde seu sistema operacional solicitará que você insira sua senha de administrador/raiz (sudo) para continuar.When you click "Install", a terminal window will appear where your OS will ask you to enter your admin / root (sudo) password to continue. Supondo que o script seja concluído com êxito, recarregue Visual Studio Code quando solicitado que você esteja tudo definido!Assuming the script completes successfully, reload Visual Studio Code when prompted you should be all set! Talvez você também queira conferir as dicas por distribuição para ver outras dicas e soluções alternativas, caso haja alguma.You may also want to check out tips by distribution for other hints and workarounds if any exist.

Caso seja exibida uma mensagem indicando que o script não dá suporte à sua distribuição, confira dicas para distribuição suportada pela comunidade para obter informações compartilhadas conosco pela comunidade.If you see a message indicating the script does not support your distribution, see tips for community supported distributions for information the community has shared with us.

Se preferir não ter vs Code executar o comando para você, você também poderá optar por executar novamente a versão mais recente desse script a qualquer momento, usando o seguinte comando em uma janela de terminal:If you prefer not to have VS Code run the command for you, you can also opt to re-run the very latest version of this script at any time manually by using the following command in a Terminal window:

wget -O ~/vsls-reqs https://aka.ms/vsls-linux-prereq-script && chmod +x ~/vsls-reqs && ~/vsls-reqs

Dicas por distribuiçãoTips by distribution

Embora o script de instalação de pré-requisito acima cubra uma variedade de distribuições, você pode estar se perguntando o que normalmente está faltando nas instalações da baunilha.While the prerequisite install script above covers a variety of distributions, you may be wondering what is typically missing from vanilla installations. A lista a seguir mostra as principais bibliotecas que estavam ausentes em uma instalação nova de uma determinada distribuição.The following list shows the key libraries that were missing in a fresh install of a given distribution. A lista também fornece algumas dicas que podem ajudá-lo a entrar em funcionamento se você clicar em um problema.The list also provides some tips that can help you get up and running if you hit a problem.

Ponto deDistribution Bibliotecas ausentes da instalação da baunilhaVanilla install missing libraries Etapas adicionaisAdditional steps
Ubuntu Desktop 18, 4 (64 bits)Ubuntu Desktop 18.04 (64-bit) <none><none> <none><none>
Ubuntu Desktop 16, 4 (64 bits)Ubuntu Desktop 16.04 (64-bit) <none><none> <none><none>
Kubuntu 18, 4 (64 bits)Kubuntu 18.04 (64-bit) gnome-keyring desktop-file-utils <none><none>
Kubuntu 16, 4 (64 bits)Kubuntu 16.04 (64-bit) gnome-keyring desktop-file-utils <none><none>
Xubuntu 18, 4 (64 bits)Xubuntu 18.04 (64-bit) <none><none>
  • Verifique se "Iniciar serviços GNOME na inicialização" está marcado na guia "avançado" de "sessão e inicialização".Ensure "Launch GNOME services on startup" is checked in the "Advanced" tab of "Session and Startup".
  • Se você tiver problemas de entrada, instale seahorse, inicie "senhas e chaves", verifique se você tem o anel de acesso de "logon" e se pode desbloqueá-lo.If you run into sign-in trouble, install seahorse, start "Passwords and Keys", verify you have "Login" keyring and that you can unlock it.
Xubuntu 16, 4 (64 bits)Xubuntu 16.04 (64-bit) <none><none>
  • Verifique se "Iniciar serviços GNOME na inicialização" está marcado na guia "avançado" de "sessão e inicialização".Ensure "Launch GNOME services on startup" is checked in the "Advanced" tab of "Session and Startup".
  • Se você tiver problemas de entrada, instale seahorse, inicie "senhas e chaves", verifique se você tem o anel de acesso de "logon" e se pode desbloqueá-lo.If you run into sign-in trouble, install seahorse, start "Passwords and Keys", verify you have "Login" keyring and that you can unlock it.
Menta 19 Cinnamon (64 bits)Mint 19 Cinnamon (64-bit) <none><none> <none><none>
Menta 18,3 Cinnamon (64 bits)Mint 18.3 Cinnamon (64-bit) <none><none> <none><none>
Teste do Debian 10 (Buster) (64 bits)Debian 10 (Buster) Testing (64-bit) Versão não estável, portanto desconhecida.Release not stable, so unknown.
Desktop de GNOME do Debian 9 (64 bits)Debian 9 GNOME Desktop (64-bit) <none><none>
  • Talvez seja necessário instalar sudo e adicionar o usuário ao grupo sudo para usar o script de instalação automatizada.You may need to install sudo and add your user to the sudo group to use the automated install script.
Fedora Workstation 29 (64 bits)Fedora Workstation 29 (64-bit) openssl-compat10 <none><none>
Estação de trabalho Fedora 28 (64 bits)Fedora Workstation 28 (64-bit) <none><none> <none><none>
Estação de trabalho Fedora 27 (64 bits)Fedora Workstation 27 (64-bit) <none><none> <none><none>
Área de trabalho de GNOME do CentOS 7 (64 bits)CentOS 7 GNOME Desktop (64-bit) <none><none> <none><none>

Confira as dicas para distribuições com suporte da Comunidade para obter informações sobre outras distribuições baseadas no não Debian/Ubuntu ou RHL.See tips for community supported distributions for information about other non-Debian / Ubuntu or RHL based distributions.

Detalhes adicionais também podem ser encontrados abaixo sobre as bibliotecas específicas Live share necessidades.Additional details can also be found below on the specific libraries Live Share needs.

Dicas para distribuições com suporte da ComunidadeTips for community supported distros

As distribuições fora das árvores Debian/Ubuntu ou RHL não são oficialmente suportadas pelo Visual Studio Code ou pelo .NET Core.Distributions outside of the Debian / Ubuntu or RHL trees are not officially supported by Visual Studio Code or .NET Core. Portanto, por extensão, eles não têm suporte oficialmente pelo Visual Studio Live Share.Therefore, by extension, they are not officially supported by Visual Studio Live Share either. No entanto, a Comunidade contribuiu com algumas informações úteis sobre como colocar Live Share em funcionamento em várias distribuições adicionais.However, the community has contributed some useful information about getting Live Share up and running on a number of additional distributions.

PRS bem-vindo: Se você estiver interessado em atualizar essas informações com sua distribuição favorita, envie uma PR para esse arquivo em nosso repositório GitHub de documentos.PRs welcome: If you're interested in updating this information with your favorite distribution, submit a PR for this file in our docs GitHub repo. Melhor ainda, se você quiser obter o instalador de dependências que oferece suporte à sua distribuição favorita, você pode enviar uma PR para esse arquivo.Even better, if you'd like to get the dependency installer supporting your favorite distribution, you can submit a PR for this file.

Ponto deDistribution Trabalhando?Working? Bibliotecas ausentes da instalação da baunilhaVanilla install missing libraries Etapas adicionaisAdditional Steps
Arch Linux (64 bits)Arch Linux (64-bit) SimYes Consoante.Varies. Bibliotecas possíveis: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xpropPossible libraries: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xprop
Manjaro 17,1 (64 bits)Manjaro 17.1 (64-bit) SimYes xorg-xprop liburcu
openSuSE LEAP 15 KDE (64 bits)openSuSE LEAP 15 KDE (64-bit) SimYes libopenssl1_0_0 gnome-keyring
  • Com suporte do script de instalação de pré-requisito.Supported by the prerequisite install script.
Solus 3 (64 bits)Solus 3 (64-bit) SimYes xprop
Gentoo (64 bits)Gentoo (64-bit) SimYes Altamente variável.Highly variable. Possíveis pacotes ausentes: dev-libs/openssl-1.0.2 net-libs/libgsasl dev-libs/icu sys-libs/zlib sys-apps/util-linux app-crypt/libsecret gnome-base/gnome-keyring x11-apps/xpropPossible missing packages: dev-libs/openssl-1.0.2 net-libs/libgsasl dev-libs/icu sys-libs/zlib sys-apps/util-linux app-crypt/libsecret gnome-base/gnome-keyring x11-apps/xprop
  • O pacote de visual-studio-code na sobreposição de jorgicio é conhecido por funcionar.The visual-studio-code package in the jorgicio overlay is known to work.

Instalar pré-requisitos manualmenteInstall prerequisites manually

Embora seja recomendável usar o script de instalação de dependênciado Live share, esta seção fornece mais detalhes sobre os requisitos de biblioteca no evento que você deseja executar essas etapas ou usar uma distribuição sem suporte pelo script.While we recommend using Live Share's dependency install script, this section provides further details on library requirements in the event you want perform these steps yourself or are using a distribution not supported by the script.

Bibliotecas típicas ausentes em instalações de baunilha podem ser encontradas nas seções dicas por distribuição e dicas para distribuições com suporte da Comunidade .Typical missing libraries in vanilla installations can be found in the tips by distribution and tips for community supported distributions sections.

Requisitos de biblioteca detalhadosDetailed library requirements

Os requisitos da biblioteca nativa do Visual Studio Live Share vêm de seu uso do .NET Core 2,1, libsecret para manter as credenciais e sua integração com o navegador.Visual Studio Live Share's native library requirements come from its use of .NET Core 2.1, libsecret to persist credentials, and its browser integration. A tabela a seguir resume esses requisitos para distribuições oficialmente suportadas pelo .NET Core.The following table summarizes these requirements for distributions officially supported by .NET Core.

Ponto deDistribution Requisitos do .NET Core.NET Core Reqs Requisitos de armazenamento de credenciaisCredential Storage Reqs Requisitos de integração de navegadorBrowser Integration Reqs
Distribuições do Ubuntu e downstreamUbuntu and downstream distributions libssl1.0.0 libkrb5-3 zlib1g libicu55 (para Ubuntu 16, 4, menta 18,3) ou libicu57 (para Ubuntu 17,10) ou libicu60 (para Ubuntu 18, 4, menta 19)libssl1.0.0 libkrb5-3 zlib1g libicu55 (for Ubuntu 16.04, Mint 18.3) or libicu57 (for Ubuntu 17.10) or libicu60 (for Ubuntu 18.04, Mint 19) libsecret-1-0 gnome-keyring (ou libsecret com suporte para keyring-KWallet não dá suporte a libsecret)libsecret-1-0 gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils x11-utils
Distribuições do Debian 9 e downstreamDebian 9 and downstream distributions libssl1.0.2 libkrb5-3 zlib1g libicu57 libsecret-1-0 gnome-keyring (ou libsecret com suporte para keyring-KWallet não dá suporte a libsecret)libsecret-1-0 gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils x11-utils
RHL/CentOS/FedoraRHL / CentOS/ Fedora openssl-libs krb5-libs zlib libicu Fedora também requer compat-openssl10openssl-libs krb5-libs zlib libicu Fedora also requires compat-openssl10 libsecret gnome-keyring (ou libsecret com suporte para keyring-KWallet não dá suporte a libsecret)libsecret gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils xorg-x11-utils
Alpine LinuxAlpine Linux openssl1.0 icu krb5 zlib libsecret gnome-keyring (ou libsecret com suporte para keyring-KWallet não dá suporte a libsecret)libsecret gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils xprop

Enquanto outras distribuições exigem as mesmas bibliotecas, seus nomes de pacote podem variar.While other distributions require the same libraries, their package names may vary. Você pode encontrar alguns deles na seção dicas para distribuições com suporte da Comunidade .You can find some of these in the tips for community supported distributions section.

Debian/UbuntuDebian / Ubuntu

As bibliotecas podem ser instaladas em distribuições baseadas em Debian/Ubuntu executando sudo apt install <library-name> em um terminal.Libraries may be installed on Debian/Ubuntu based distributions by running sudo apt install <library-name> in a terminal.

Para distribuições baseadas no Ubuntu, incluindo menta, execute:For Ubuntu based distributions including Mint, run:

sudo apt install libssl1.0.0 libkrb5-3 zlib1g libicu[0-9][0-9] gnome-keyring libsecret-1-0 desktop-file-utils x11-utils

Para distribuições downstream do Debian 9 e não do Ubuntu, execute:For Debian 9 and non-Ubuntu downstream distributions, run:

sudo apt install libssl1.0.2 libkrb5-3 zlib1g libicu57 gnome-keyring libsecret-1-0 desktop-file-utils x11-utils

Fedora / CentOS / RHLFedora / CentOS / RHL

As bibliotecas podem ser instaladas em distribuições baseadas em Fedora/CentOS/RHL executando sudo yum install <library-name> em um terminal.Libraries may be installed on Fedora/CentOS/RHL based distributions by running sudo yum install <library-name> in a terminal. Por exemplo, isso instalará tudo:For example, this will install everything:

sudo yum install openssl-libs compat-openssl10 krb5-libs zlib libicu libsecret gnome-keyring desktop-file-utils xorg-x11-utils

Problemas de VS Code OSSVS Code OSS Issues

Usuários do Manjaro/Linux Arch: Use o pacote do Visual-Studio-bin Aur para evitar esse problema.Arch Linux/Manjaro Users: Use the visual-studio-bin AUR package to avoid this problem.

Pacotes de Visual Studio Code que são versões baunilha ou modificadas do VS Code OSS podem ter um valor crítico ausente no arquivo product.json que impede que o Visual Studio Live Share seja ativado.Packages of Visual Studio Code that are either vanilla or modified versions of VS Code OSS can be missing a critical value in product.json file that prevents Visual Studio Live Share from activating.

Uma maneira rápida de ver que você pode estar atingindo esse problema é acessar a ajuda > "alternar Ferramentas para Desenvolvedores" e ver se você encontra um rastreamento de pilha indicando que a extensão Live Share não foi ativada porque estava usando uma "API proposta".A quick way to see you might be hitting this problem is to go to Help > "Toggle Developer Tools" and see if you find a stack trace indicating the Live Share extension did not activate because it was using a "proposed API."

Para verificar se esse é o seu problema, verifique o conteúdo de product.json.To verify this is your issue, check the contents of product.json. O local do arquivo varia de acordo com o pacote, mas geralmente está em um dos seguintes locais:The file's location does vary by package, but it is usually in one of the following locations:

  • /usr/share/code/resources/app/product.json
  • /usr/share/vscode/resources/app/product.json

Se a propriedade extensionAllowedProposedApi estiver ausente ou se você não vir "MS-vsliveshare. vsliveshare" referenciado, você está usando uma versão do OSS com esse problema.If the extensionAllowedProposedApi property is missing or you do not see "ms-vsliveshare.vsliveshare" referenced, you are using an OSS version with this problem.

Como alternativa, você pode adicionar o seguinte ao Product. JSON:As a workaround, you can add the following into the product.json:

    "extensionAllowedProposedApi": [
      "ms-vsliveshare.vsliveshare",
      "ms-vscode.node-debug",
      "ms-vscode.node-debug2"
 ]

Veja acima para obter detalhes adicionais sobre se a distribuição que você está usando é conhecida como trabalho.See above for additional details on whether the distribution you are using is known to work.

Integração do navegador do LinuxLinux browser integration

Geralmente, o Visual Studio Live Share não exige etapas de instalação adicionais para permitir a integração do navegador no Linux.Visual Studio Live Share typically does not require additional installation steps to enable browser integration on Linux.

Para fazer isso, Live Share coloca automaticamente um arquivo de área de trabalho em ~/.local/share/applications e o iniciador necessário em ~/.local/share/vsliveshare quando a extensão é inicializada pela primeira vez.To accomplish this, Live Share automatically places a desktop file in ~/.local/share/applications and the required launcher itself in ~/.local/share/vsliveshare when the extension first initializes. Nenhuma ação será necessária em sua parte se isso tiver sucesso.No action is required on your part if this succeeds.

Em alguns casos, as distribuições não dão suporte a esse local ou exigem ajustes para que funcionem com suas instalações de baunilha.In some cases, distributions either do not support this location or require tweaks to get it to work with their vanilla installs. Nesses casos, Live Share voltar a usar /usr/local/share em vez disso.In these cases, Live Share falls back to using /usr/local/share instead. Como resultado, você pode ser notificado de que sua senha de administrador (sudo) é necessária para concluir o processo de instalação.As a result, you may be notified that your admin (sudo) password is required to complete the installation process. Uma janela do terminal será exibida informando a você onde o inicializador do navegador será instalado.A terminal window will appear telling you where the browser launcher will be installed. Basta digitar a senha quando solicitado e pressionar enter assim que a instalação for concluída para fechar janela do terminal.Simply enter your password when prompted and press enter once the installation completes to close the terminal window.

Se preferir executar o comando por conta própria, clique em "copiar", que copiará o comando de terminal para a área de transferência em vez disso.If you'd prefer to run the command yourself instead, you can click "Copy instead" which will copy the terminal command to the clipboard instead.

Por fim, se você optar por ignorar essa etapa por completo, ainda poderá unir as sessões de colaboração manualmente, mas não poderá ingressar abrindo um link de convite no navegador.Finally, if you opt to skip this step entirely, you can still join collaboration sessions manually, but you will not be able to join by opening an invite link in the browser. Observe que você sempre pode acessar o comando mais tarde, pressionando Ctrl + Shift + P/Cmd + Shift + P e selecionando o comando "Live share: setup do Launcher".Note that you can always access the command again later, by hitting Ctrl+Shift+P / Cmd+Shift+P and selecting the "Live Share: Launcher Setup" command.

Veja tambémSee also

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