Dettagli di installazione di Linux

Linux è un ambiente estremamente variabile e con l'aumentare del numero di distribuzioni e ambienti desktop l'esecuzione può diventare complessa. Se si usano le versioni supportate di Ubuntu Desktop (16.04 +), CentOS 7o Fedora workstation (27 +) e si usano solo le distribuzioni ufficiali di vs code, è necessario trovare il processo in modo semplice. Tuttavia, nel caso in cui si usi una configurazione non standard o una distribuzione downstream, potrebbero verificarsi alcuni intoppi. In questo documento vengono fornite alcune informazioni sui requisiti e alcuni dettagli per la risoluzione dei problemi che possono risultare utili per essere operativi anche se la configurazione è supportata solo dalla community. Si noti che Live Share supporta solo Linux a 64 bit.

Installare i prerequisiti Linux

In alcune distribuzioni di Linux mancano le librerie necessarie per il funzionamento di Live Share. Per impostazione predefinita, Live Share cerca di rilevare e installare i prerequisiti Linux automaticamente. Quando Live Share rileva un problema che può essere dovuto a librerie mancanti, viene visualizzata una notifica di tipo avviso popup in cui viene chiesta l'autorizzazione per l'installazione.

Notifica di tipo avviso popup che mostra il messaggio che mancano i prerequisiti di Linux

Quando si fa clic su "Installa", viene visualizzata una finestra del terminale in cui il sistema operativo chiederà di immettere la password di amministratore/radice (sudo) per continuare. Supponendo che lo script venga completato correttamente, ricaricare Visual Studio Code quando richiesto, è necessario essere tutti impostati. È anche possibile vedere Suggerimenti per la distribuzione per altri suggerimenti e soluzioni alternative, se disponibili.

Se viene visualizzato un messaggio che indica che lo script non supporta la distribuzione, vedere i suggerimenti per le distribuzioni supportate dalla community per informazioni condivise dalla community.

Se si preferisce non usare vs code eseguire il comando per l'utente, è anche possibile scegliere di eseguire di nuovo la versione più recente di questo script in qualsiasi momento manualmente usando il comando seguente in una finestra del terminale:

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

Suggerimenti per distribuzione

Mentre lo script di installazione dei prerequisiti sopra riportato copre un'ampia gamma di distribuzioni, è possibile che si stiano chiedendo cosa in genere manca dalle installazioni di vaniglia. Nell'elenco seguente vengono illustrate le librerie principali mancanti in una nuova installazione di una determinata distribuzione. Nell'elenco sono inoltre disponibili alcuni suggerimenti che consentono di iniziare a funzionare se si riscontra un problema.

Punto di Librerie mancanti nell'installazione di Vanilla Passaggi aggiuntivi
Ubuntu Desktop 18,04 (64 bit) <none> <none>
Ubuntu Desktop 16,04 (64 bit) <none> <none>
Kubuntu 18,04 (64 bit) gnome-keyring desktop-file-utils <none>
Kubuntu 16,04 (64 bit) gnome-keyring desktop-file-utils <none>
Xubuntu 18,04 (64 bit) <none>
  • Assicurarsi che l'opzione "Avvia servizi GNOME all'avvio" sia selezionata nella scheda "avanzate" di "sessione e avvio".
  • Se si verificano problemi di accesso, installare seahorse, avviare "password e chiavi", verificare di avere il portachiavi "login" e di poterlo sbloccare.
Xubuntu 16.04 (64-bit) <none>
  • Assicurarsi che l'opzione "Avvia servizi GNOME all'avvio" sia selezionata nella scheda "avanzate" di "sessione e avvio".
  • Se si verificano problemi di accesso, installare seahorse, avviare "password e chiavi", verificare di avere il portachiavi "login" e di poterlo sbloccare.
Mint 19 Cinnamon (64 bit) <none> <none>
Menta 18,3 cannella (64 bit) <none> <none>
Test Debian 10 (Buster) (64 bit) Il rilascio non è stabile, quindi è sconosciuto.
Debian 9 GNOME desktop (64 bit) <none>
  • Potrebbe essere necessario installare sudo e aggiungere l'utente al gruppo sudo per usare lo script di installazione automatica.
Workstation Fedora 29 (64 bit) openssl-compat10 <none>
Workstation Fedora 28 (64 bit) <none> <none>
Workstation Fedora 27 (64 bit) <none> <none>
CentOS 7 GNOME desktop (64 bit) <none> <none>

Per informazioni su altre distribuzioni non Debian/Ubuntu o basate su RHL, vedere Suggerimenti per le distribuzioni supportate dalla community .

Ulteriori dettagli sono disponibili anche di seguito per le librerie specifiche Live Share esigenze.

Suggerimenti per le distribuzioni supportate dalla community

Le distribuzioni all'esterno degli alberi Debian/Ubuntu o RHL non sono ufficialmente supportate da Visual Studio Code o .NET Core. Pertanto, per estensione, non sono ufficialmente supportati da Visual Studio Live Share. Tuttavia, la community ha fornito alcune informazioni utili su come ottenere Live Share operativi in diverse distribuzioni aggiuntive.

Richieste pull : Se si è interessati a aggiornare queste informazioni con la distribuzione preferita, inviare una richiesta pull per questo file nel repository GitHub docs. Ancora meglio, se si vuole ottenere il programma di installazione delle dipendenze che supporta la distribuzione preferita, è possibile inviare una richiesta pull per questo file.

Punto di Utilizzo? Librerie mancanti nell'installazione di Vanilla Passaggi aggiuntivi
Arch Linux (64 bit) Varia. Librerie possibili: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xprop
Manjaro 17,1 (64 bit) xorg-xprop liburcu
openSuSE LEAP 15 KDE (64 bit) libopenssl1_0_0 gnome-keyring
  • Supportato dallo script di installazione dei prerequisiti.
Solus 3 (64 bit) xprop
Gentoo (64 bit) Estremamente variabile. Possibili pacchetti mancanti: 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
  • Il pacchetto visual-studio-code nella sovrimpressione jorgicio è noto come funzionante.

Installare i prerequisiti manualmente

Sebbene sia consigliabile utilizzare lo script di installazione delle dipendenzedi Live Share, in questa sezione vengono fornite ulteriori informazioni sui requisiti della libreria nel caso in cui si desideri eseguire questi passaggi manualmente o se si utilizza una distribuzione non supportata dallo script.

Le librerie mancanti tipiche nelle installazioni Vanilla sono disponibili nelle sezioni Suggerimenti per distribuzione e Suggerimenti per le distribuzioni supportate dalla community .

Requisiti della libreria dettagliati

I requisiti della libreria nativa di Visual Studio Live Share derivano dall'uso di .NET Core 2,1, libsecret per salvare in modo permanente le credenziali e l'integrazione del browser. La tabella seguente riepiloga questi requisiti per le distribuzioni ufficialmente supportate da .NET Core.

Punto di Rich di .NET Core Rich di archiviazione delle credenziali Integrazione del browser Rich
Distribuzioni Ubuntu e downstream libssl1.0.0 libkrb5-3 zlib1g libicu55 (per Ubuntu 16,04, Mint 18,3) o libicu57 (per Ubuntu 17,10) o libicu60 (per Ubuntu 18,04, Mint 19) libsecret-1-0 gnome-keyring (o il portachiavi supportato da libsecret-KWallet non supporta libsecret) desktop-file-utils x11-utils
Debian 9 e distribuzioni downstream libssl1.0.2 libkrb5-3 zlib1g libicu57 libsecret-1-0 gnome-keyring (o il portachiavi supportato da libsecret-KWallet non supporta libsecret) desktop-file-utils x11-utils
RHL/CentOS/Fedora openssl-libs krb5-libs zlib libicu Fedora richiede anche compat-openssl10 libsecret gnome-keyring (o il portachiavi supportato da libsecret-KWallet non supporta libsecret) desktop-file-utils xorg-x11-utils
Alpine Linux openssl1.0 icu krb5 zlib libsecret gnome-keyring (o il portachiavi supportato da libsecret-KWallet non supporta libsecret) desktop-file-utils xprop

Mentre altre distribuzioni richiedono le stesse librerie, i relativi nomi di pacchetto possono variare. Alcuni di questi sono disponibili nella sezione Suggerimenti per distribuzioni supportate dalla community .

Debian/Ubuntu

Le librerie possono essere installate in distribuzioni basate su Debian/Ubuntu eseguendo sudo apt install <library-name> in un terminale.

Per le distribuzioni basate su Ubuntu, incluso Mint, eseguire:

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

Per le distribuzioni di Debian 9 e non Ubuntu downstream, eseguire:

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

Fedora/CentOS/RHL

Le librerie possono essere installate nelle distribuzioni basate su Fedora/CentOS/RHL eseguendo sudo yum install <library-name> in un terminale. Ad esempio, verrà installato tutto:

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

Problemi di VS Code OSS

Utenti Arch Linux/Manjaro: Per evitare questo problema, usare il pacchetto Visual Studio-bin AUR.

È possibile che nel file product.json non sia presente un valore critico per i pacchetti di Visual Studio Code che sono di tipo Vanilla o versioni modificate di VS Code OSS, che impedisce l'attivazione di Visual Studio Live Share.

Un modo rapido per vedere questo problema consiste nel passare alla Guida > "attivare o disattivare Strumenti di sviluppo" e verificare se è presente una traccia dello stack che indica che l'estensione Live Share non è stata attivata perché è stata usata una "API proposta".

Per verificare il problema, controllare il contenuto del product.json. Il percorso del file varia a seconda del pacchetto, ma in genere si trova in una delle posizioni seguenti:

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

Se la proprietà extensionAllowedProposedApi è mancante o non viene visualizzato "MS-vsliveshare. vsliveshare" a cui si fa riferimento, si sta usando una versione OSS con questo problema.

Come soluzione alternativa, è possibile aggiungere quanto segue nel file Product. JSON:

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

Vedere sopra per ulteriori informazioni sulla modalità di funzionamento della distribuzione in uso.

Integrazione del browser in Linux

Visual Studio Live Share in genere non richiede passaggi di installazione aggiuntivi per abilitare l'integrazione del browser in Linux.

A tale scopo, Live Share inserisce automaticamente un file desktop in ~/.local/share/applications e l'utilità di avvio necessaria in ~/.local/share/vsliveshare quando l'estensione viene inizializzata per la prima volta. Se l'operazione ha esito positivo, non è richiesta alcuna azione da parte dell'utente.

In alcuni casi, le distribuzioni non supportano questo percorso o richiedono modifiche per farlo funzionare con le installazioni di Vanilla. In questi casi, Live Share esegue invece il fallback all'utilizzo di /usr/local/share. Di conseguenza, è possibile che venga visualizzata una notifica che indica che la password di amministratore (sudo) è necessaria per completare il processo di installazione. Verrà visualizzata una finestra del terminale in cui è indicato dove verrà installata l'utilità di avvio del browser. Immettere la password quando richiesto e premere INVIO dopo il completamento dell'installazione per chiudere la finestra del terminale.

Se invece si preferisce eseguire il comando, è possibile fare clic su "copy" (copia in alternativa) per copiare il comando del terminale negli Appunti.

Infine, se si sceglie di ignorare questo passaggio completamente, è ancora possibile unire le sessioni di collaborazione manualmente, ma non sarà possibile partecipare aprendo un collegamento di invito nel browser. Si noti che è sempre possibile accedere nuovamente al comando in un secondo momento premendo CTRL + MAIUSC + P/Cmd + Maiusc + P e selezionando il comando "Live Share: Launcher Setup".

Vedere anche

Si verificano problemi? Vedere la risoluzione dei problemi o inviare un feedback.