Detalhes de Instalação do Linux

Linux é um ambiente altamente variável e, com o grande número de ambientes de desktop e distribuições, pode ser complicado trabalhar. Se você se ater às versões com suporte do Ubuntu Desktop (16.04+), CentOS 7 ou Fedora Workstation (27+) e usar apenas distribuições oficiais de VS Code, você deverá encontrar o processo diretamente. No entanto, se estiver usando uma configuração não padrão ou distribuição downstream, pode ser que você passe por alguns contratempos. Este documento fornece algumas informações sobre os requisitos e alguns detalhes de solução de problemas que podem ajudá-lo a se atualizar, mesmo que sua configuração seja apenas compatível com a comunidade. Observe que Live Share dá suporte apenas ao Linux de 64 bits.

Instalar pré-requisitos do Linux

Algumas distribuições do Linux têm bibliotecas que o Live Share precisa para funcionar. Por padrão, o Live Share tenta detectar e instalar os pré-requisitos do Linux para você. 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.

Toast notification showing message that Linux pre-requisites are missing

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. Supondo que o script seja concluído com êxito, recarregue Visual Studio Code quando for solicitado que você esteja pronto! Talvez você também queira conferir as dicas por distribuição para ver outras dicas e soluções alternativas, caso haja alguma.

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.

Se você preferir não ter VS Code executar o comando para você, também poderá optar por executar novamente a versão mais recente desse script a qualquer momento manualmente usando o seguinte comando em uma janela do Terminal:

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

Dicas por distribuição

Embora o script de instalação de pré-requisitos acima abrange uma variedade de distribuições, você pode estar se perguntando o que normalmente está faltando nas instalações de baunilha. A lista a seguir mostra as principais bibliotecas que estavam ausentes em uma nova instalação de uma determinada distribuição. A lista também fornece algumas dicas que podem ajudá-lo a se levantar e executar se você tiver um problema.

Distribuição Instalar bibliotecas ausentes do Vanilla Etapas adicionais
Ubuntu Desktop 22.04 (64 bits) libssl1.1 <nenhum>
Ubuntu Desktop 18.04 (64 bits) <nenhum> <nenhum>
Ubuntu Desktop 16.04 (64 bits) <nenhum> <nenhum>
Kubuntu 18.04 (64 bits) gnome-keyring desktop-file-utils <nenhum>
Kubuntu 16.04 (64 bits) gnome-keyring desktop-file-utils <nenhum>
Xubuntu 18.04 (64 bits) <nenhum>
  • Verifique se "Iniciar serviços GNOME na inicialização" está marcado na guia "Avançado" de "Sessão e Inicialização".
  • Se você tiver problemas de entrada, instale , inicie seahorse"Senhas e Chaves", verifique se você tem o keyring "Logon" e se pode desbloqueá-lo.
Xubuntu 16.04 (64 bits) <nenhum>
  • Verifique se "Iniciar serviços GNOME na inicialização" está marcado na guia "Avançado" de "Sessão e Inicialização".
  • Se você tiver problemas de entrada, instale , inicie seahorse"Senhas e Chaves", verifique se você tem o keyring "Logon" e se pode desbloqueá-lo.
Hortelã 19 Canela (64 bits) <nenhum> <nenhum>
Hortelã 18.3 Canela (64 bits) <nenhum> <nenhum>
Teste do Debian 10 (Buster) (64 bits) Liberação não estável, tão desconhecida.
Debian 9 GNOME Desktop (64 bits) <nenhum>
  • Talvez seja necessário instalar sudo e adicionar o usuário ao grupo sudo para usar o script de instalação automatizado.
Fedora Workstation 29 (64 bits) openssl-libs <nenhum>
Fedora Workstation 28 (64 bits) <nenhum> <nenhum>
Fedora Workstation 27 (64 bits) <nenhum> <nenhum>
CentOS 7 GNOME Desktop (64 bits) <nenhum> <nenhum>

Confira dicas para distribuições com suporte da comunidade para obter informações sobre outras distribuições não baseadas em Debian/Ubuntu ou RHL.

Detalhes adicionais também podem ser encontrados abaixo nas bibliotecas específicas Live Share necessidades.

Dicas para distribuições com suporte da comunidade

Distribuições fora das árvores Debian/Ubuntu ou RHL não são oficialmente suportadas por Visual Studio Code ou .NET Core. Portanto, por extensão, eles também não têm suporte oficial por Visual Studio Live Share. No entanto, a comunidade contribuiu com algumas informações úteis sobre como colocar Live Share em funcionamento em várias distribuições adicionais.

PRs bem-vindos: Se você estiver interessado em atualizar essas informações com sua distribuição favorita, envie uma PR para esse arquivo em nossos documentos GitHub repositório. Melhor ainda, se você quiser obter o instalador de dependência que dá suporte à distribuição favorita, envie uma PR para este arquivo.

Distribuição Trabalhando? Instalar bibliotecas ausentes do Vanilla Etapas adicionais
Arch Linux (64 bits) Sim Varia. Bibliotecas possíveis: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xprop icu69
Manjaro 17.1 (64 bits) Sim xorg-xprop liburcu icu69
openSuSE LEAP 15 KDE (64 bits) Sim libopenssl1_0_0 gnome-keyring
  • Compatível com o script de instalação de pré-requisitos.
Solus 3 (64 bits) Sim xprop
Gentoo (64 bits) Sim Altamente variável. 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/xprop
  • O visual-studio-code pacote na sobreposição jorgicio é conhecido por funcionar.

Instalar pré-requisitos manualmente

Embora seja recomendável usar o script de instalação de dependência do Live Share, esta seção fornece mais detalhes sobre os requisitos de biblioteca caso você queira executar essas etapas por conta própria ou esteja usando uma distribuição sem suporte do script.

Bibliotecas típicas ausentes em instalações de baunilha podem ser encontradas nas dicas por meio de distribuição e dicas para seções de distribuição com suporte da comunidade .

Requisitos detalhados da biblioteca

Os requisitos de biblioteca nativa da Visual Studio Live Share vêm do uso do .NET Core 2.1, do libsecret para persistir as credenciais e da integração do navegador. A tabela a seguir resume esses requisitos para distribuições oficialmente compatíveis com o .NET Core.

Distribuição Reqs do .NET Core Credencial Armazenamento Reqs Perguntas frequentes sobre integração do navegador
Distribuições do Ubuntu e downstream libssl1.0.0 libkrb5-3 zlib1g libicu55 (para Ubuntu 16.04, Mint 18.3) ou libicu57 (para Ubuntu 17.10) ou libicu60 (para Ubuntu 18.04, Mint 19) libsecret-1-0 gnome-keyring (ou chaveiro com suporte libsecret - Kwallet não dá suporte a libsecret) desktop-file-utils x11-utils
Distribuições de debian 9 e downstream libssl1.0.2 libkrb5-3 zlib1g libicu57 libsecret-1-0 gnome-keyring (ou chaveiro com suporte libsecret - Kwallet não dá suporte a libsecret) desktop-file-utils x11-utils
RHL / CentOS/ Fedora openssl-libs krb5-libs zlib libicu Fedora também requer openssl-libs libsecret gnome-keyring (ou chaveiro com suporte libsecret - Kwallet não dá suporte a libsecret) desktop-file-utils xprop
Alpine Linux openssl1.1 icu krb5 zlib libsecret gnome-keyring (ou chaveiro com suporte libsecret - Kwallet não dá suporte a libsecret) desktop-file-utils xprop

Embora outras distribuições exijam as mesmas bibliotecas, seus nomes de pacote podem variar. Você pode encontrar algumas delas na seção dicas para distribuições com suporte da comunidade .

Debian/Ubuntu

As bibliotecas podem ser instaladas em distribuições baseadas no Debian/Ubuntu executando sudo apt install <library-name> em um terminal.

Para distribuições baseadas no Ubuntu, incluindo a Casa da Moeda, execute:

sudo apt install libssl1.1 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 Ubuntu, execute:

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

Fedora / CentOS / RHL

As bibliotecas podem ser instaladas em distribuições baseadas em Fedora/CentOS/RHL executando sudo yum install <library-name> em um terminal. Por exemplo, isso instalará tudo:

    sudo yum install openssl-libs krb5-libs zlib libicu libsecret gnome-keyring desktop-file-utils xprop

VS Code problemas de SOS

Arch Linux/Manjaro Users: Use o pacote AUR do visual-studio-bin para evitar esse problema.

Pacotes de Visual Studio Code que são versões de baunilha ou modificadas de VS Code OSS podem estar sem um valor crítico no product.json arquivo que impede que Visual Studio Live Share ativem.

Uma maneira rápida de ver que você pode estar atingindo esse problema é acessar a Ajuda > para "Alternar Ferramentas de Desenvolvedor" e ver se você encontrou um rastreamento de pilha indicando que a extensão Live Share não foi ativada porque estava usando uma "API proposta".

Para verificar se esse é o seu problema, verifique o conteúdo de product.json. O local do arquivo varia de acordo com o pacote, mas geralmente está em um dos seguintes locais:

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

Se a extensionAllowedProposedApi propriedade estiver ausente ou você não vir "ms-vsliveshare.vsliveshare" referenciado, você está usando uma versão do OSS com esse problema.

Como solução alternativa, você pode adicionar o seguinte ao product.json:

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

Confira mais detalhes sobre se a distribuição que você está usando é conhecida por funcionar.

Integração do navegador do Linux

Geralmente, o Visual Studio Live Share não exige etapas de instalação adicionais para permitir a integração do navegador no Linux.

Para fazer isso, Live Share coloca automaticamente um arquivo da ~/.local/share/applications área de trabalho e o próprio inicializador necessário quando ~/.local/share/vsliveshare a extensão é inicializada pela primeira vez. Nenhuma ação será necessária de sua parte se isso for bem-sucedido.

Em alguns casos, as distribuições não dão suporte a esse local ou exigem ajustes para fazê-lo funcionar com suas instalações de baunilha. Nesses casos, Live Share volta a usar/usr/local/share. Como resultado, você pode ser notificado de que sua senha de administrador (sudo) é necessária para concluir o processo de instalação. Uma janela do terminal será exibida informando a você onde o inicializador do navegador será instalado. Basta digitar a senha quando solicitado e pressionar enter assim que a instalação for concluída para fechar janela do terminal.

Se preferir executar o comando por conta própria, clique em "Copiar em vez disso", que copiará o comando do terminal para a área de transferência.

Por fim, se você optar por ignorar totalmente essa etapa, ainda poderá ingressar nas sessões de colaboração manualmente, mas não poderá ingressar abrindo um link de convite no navegador. Observe que você sempre pode acessar o comando novamente mais tarde, clicando em Ctrl+Shift+P/Cmd+Shift+P e selecionando o comando "Live Share: Configuração do Inicializador".

Confira também

Está tendo problemas? Confira Solução de problemas ou envie comentários.