Сведения об установке Linux

Среда Linux крайне разнообразна, и большой выбор сред и дистрибутивов для рабочего стола существенно усложняет подготовку к работе. если вы прийдете к поддерживаемым версиям Ubuntu Desktop (16.04 +), CentOS 7 или Fedora Workstation (27 +) и используете только официальные дистрибутивы VS Code, процесс должен быть прямо вперед. Но если же вам нужна нестандартная конфигурация или подчиненный дистрибутив, в некоторых случаях могут возникать проблемы. В этом документе приведены некоторые сведения о требованиях и некоторые сведения по устранению неполадок, которые могут помочь в работе, даже если ваша конфигурация поддерживается только сообществом. обратите внимание, что Live Share поддерживает только 64-разрядную версию Linux.

Установка необходимых компонентов для Linux

В некоторых дистрибутивах Linux отсутствуют библиотеки, без которых Live Share работать не может. По умолчанию Live Share пытается обнаружить и установить все необходимые компоненты Linux. Если Live Share обнаружит проблему, которая может быть связана с отсутствием библиотек, вы увидите всплывающее уведомление с запросом разрешений на их установку.

Всплывающее уведомление с сообщением о том, что предварительные требования Linux отсутствуют

При нажатии кнопки "установить" появится окно терминала, в котором ваша ОС предложит вам ввести пароль администратора или корня (sudo), чтобы продолжить. предполагая, что сценарий успешно завершает работу, перезагрузите Visual Studio Code при появлении запроса вы должны быть все готово. Вы также можете проверить советы для конкретного дистрибутива , где могут быть описаны дополнительные сложности и (или) обходные пути.

Если появится сообщение о том, что скрипт не поддерживает выбранный дистрибутив, воспользуйтесь рекомендациями по дистрибутивам, поддерживаемым сообществом , где собраны все сведения, предоставленные нам сообществом.

если вы не хотите, чтобы VS Code выполнили команду, вы можете в любое время повторно запустить самую последнюю версию этого скрипта вручную, используя следующую команду в окне терминала:

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

Советы по распределению

Хотя сценарий установки, приведенный выше, охватывает разнообразные дистрибутивы, вы можете заинтересовать, что обычно отсутствует в обычный установках. В следующем списке приведены ключевые библиотеки, отсутствующие в новой установке данного дистрибутива. В списке также приводятся некоторые советы, которые помогут вам приступить к работе, если вы столкнулись с проблемой.

Distribution Обычный установить отсутствующие библиотеки Дополнительные действия
Ubuntu Desktop 18,04 (64-разрядная версия) <Нет> <Нет>
Ubuntu Desktop 16,04 (64-разрядная версия) <Нет> <Нет>
Кубунту 18,04 (64-разрядная версия) gnome-keyring desktop-file-utils <Нет>
Кубунту 16,04 (64-разрядная версия) gnome-keyring desktop-file-utils <Нет>
Ксубунту 18,04 (64-разрядная версия) <Нет>
  • Убедитесь, что флажок "запустить GNOME Services при запуске" установлен на вкладке "Дополнительно" в "сеансе и запуске".
  • Если при входе в систему возникают проблемы с входом, установите seahorse , запустите "пароли и ключи", убедитесь, что у вас есть набор ключей "Login", и вы можете разблокировать его.
Ксубунту 16,04 (64-разрядная версия) <Нет>
  • Убедитесь, что флажок "запустить GNOME Services при запуске" установлен на вкладке "Дополнительно" в "сеансе и запуске".
  • Если при входе в систему возникают проблемы с входом, установите seahorse , запустите "пароли и ключи", убедитесь, что у вас есть набор ключей "Login", и вы можете разблокировать его.
Mint 19 корицей (64-разрядная версия) <Нет> <Нет>
Mint 18,3 корицей (64-разрядная версия) <Нет> <Нет>
Тестирование Debian 10 (бустер) (64-разрядная версия) Выпуск не стабильны, поэтому неизвестно.
Debian 9 GNOME Desktop (64-разрядная версия) <Нет>
  • Возможно, потребуется установить sudo и добавить пользователя в группу sudo для использования скрипта автоматической установки.
Fedora Workstation 29 (64-разрядная версия) openssl-compat10 <Нет>
Fedora Workstation 28 (64-разрядная версия) <Нет> <Нет>
Fedora Workstation 27 (64-разрядная версия) <Нет> <Нет>
CentOS 7 GNOME Desktop (64-разрядная версия) <Нет> <Нет>

Дополнительные сведения о других дистрибутивах, не являющихся Debian, Ubuntu и РХЛ, см. в разделе Советы по поддержке сообщества .

дополнительные сведения также можно найти в конкретных библиотеках Live Share потребностей.

Советы, поддерживаемый сообществом дистрибутивов

дистрибутивы за пределами Debian/Ubuntu или рхл официально не поддерживаются Visual Studio Code или .net Core. таким образом, по расширениям они официально не поддерживаются Visual Studio Live Share либо. тем не менее, сообществом предоставлены некоторые полезные сведения о Live Share и работе с несколькими дополнительными дистрибутивами.

Добро пожаловать в вытягивание: если вы хотите обновить эту информацию с помощью избранного распространения, отправьте запрос на включение внесенных изменений для этого файла в наш документ GitHub репозиторий. Еще лучше, если вы хотите получить установщик зависимостей, поддерживающий любимое распространение, вы можете отправить запрос на вытягивание для этого файла.

Distribution Работающих? Обычный установить отсутствующие библиотеки Дополнительные действия
Arch Linux (64-разрядная версия) Да Возможны разные варианты. Возможные библиотеки: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xprop
Манжаро 17,1 (64-разрядная версия) Да xorg-xprop liburcu
openSuSE LEAP 15 KDE (64-разрядный) Да libopenssl1_0_0 gnome-keyring
  • Поддерживается сценарием установки необходимых компонентов.
Солус 3 (64-разрядная версия) Да xprop
Женту (64-разрядная версия) Да Высокая переменная. Возможные отсутствующие пакеты: 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
  • visual-studio-codeПакет в наложении жоргиЦио известен.

Установить необходимые компоненты вручную

хотя мы рекомендуем использовать сценарий установки зависимостей Live Share, в этом разделе содержатся дополнительные сведения о требованиях к библиотеке в случае, когда необходимо выполнить эти действия самостоятельно или использовать распространение, которое не поддерживается сценарием.

Стандартные отсутствующие библиотеки в установках обычный можно найти в разделе Советы по распространению и Советы по поддержке сообщества .

Подробные требования к библиотеке

требования к собственной библиотеке Visual Studio Live Share, которые используют .net Core 2,1, libsecret для сохранения учетных данных и интеграции с браузером. В следующей таблице перечислены требования к дистрибутивам, официально поддерживаемые .NET Core.

Distribution Запросов секунду .NET Core учетные данные служба хранилища запросов секунду Интеграция с браузером запросов секунду
Ubuntu и нисходящие распределения libssl1.0.0 libkrb5-3 zlib1g libicu55 (для Ubuntu 16,04, Mint 18,3) или libicu57 (для ubuntu 17,10) или libicu60 (для Ubuntu 18,04, Mint 19) libsecret-1-0 gnome-keyring (или libsecret поддерживаемые набор ключей-Кваллет не поддерживает libsecret) desktop-file-utils x11-utils
Debian 9 и нисходящие распределения libssl1.0.2 libkrb5-3 zlib1g libicu57 libsecret-1-0 gnome-keyring (или libsecret поддерживаемые набор ключей-Кваллет не поддерживает libsecret) desktop-file-utils x11-utils
РХЛ/CentOS/Fedora openssl-libs krb5-libs zlib libicu Для Fedora также требуется compat-openssl10 libsecret gnome-keyring (или libsecret поддерживаемые набор ключей-Кваллет не поддерживает libsecret) desktop-file-utils xorg-x11-utils
Alpine Linux openssl1.0 icu krb5 zlib libsecret gnome-keyring (или libsecret поддерживаемые набор ключей-Кваллет не поддерживает libsecret) desktop-file-utils xprop

Хотя для других дистрибутивов требуются одни и те же библиотеки, их имена пакетов могут отличаться. Некоторые из них можно найти в разделе Советы по распространению поддерживаемых сообществ .

Debian и Ubuntu

Библиотеки можно установить в дистрибутивах на основе Debian или Ubuntu, запустив sudo apt install <library-name> в терминале.

Для дистрибутивов на основе Ubuntu, включая Mint, выполните:

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

Для Debian 9 и нижестоящих дистрибутивов, не относящихся к Ubuntu, выполните следующую команду:

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

Fedora/CentOS/РХЛ

Библиотеки можно установить в дистрибутивах на основе Fedora/CentOS/РХЛ, запустив sudo yum install <library-name> в терминале. Например, все будет установлено:

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

VS Code Проблемы OSS

Манжаро пользователей Linux/с: Чтобы избежать этой проблемы, используйте пакет Visual-Studio-bin Aur.

пакеты Visual Studio Code, которые либо обычный, либо изменили версии VS Code OSS, могут не содержать критическое значение в product.json файле, которое предотвращает активацию Visual Studio Live Share.

чтобы быстро увидеть, что эта проблема может возникнуть, перейдите к справке > "переключить Средства для разработчиков" и проверьте, найдена ли трассировка стека, указывающая, что расширение Live Share не было активировано, так как оно использовало "предложенный API".

Чтобы убедиться в наличии проблемы, проверьте содержимое product.json . Расположение файла зависит от пакета, но обычно находится в одном из следующих расположений:

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

Если extensionAllowedProposedApi свойство отсутствует или не отображается ссылка MS-всливешаре. всливешаре, используется версия OSS с этой проблемой.

В качестве обходного решения можно добавить следующий элемент в product.js:

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

Дополнительные сведения о том, работает ли используемое распределение, см. выше .

Интеграция с браузером в Linux

Visual Studio Live Share обычно не требует дополнительных действий при установке для интеграции с браузером на платформе Linux.

для этого Live Share автоматически помещает файл настольного компьютера в ~/.local/share/applications и обязательное средство запуска в ~/.local/share/vsliveshare процессе инициализации расширения. Если эта операция будет выполнена, никаких действий не требуется.

В некоторых случаях дистрибутивы либо не поддерживают это расположение, либо не нуждаются в настройке, чтобы заставить его работать с обычный установками. в таких случаях Live Share перестает использовать /usr/local/share вместо них. В результате вы можете получить уведомления о том, что для завершения процесса установки требуется пароль администратора (sudo) . В этом случае появится окно терминала с информацией о том, где будет установлено средство для запуска браузера. Просто введите пароль в ответ на соответствующий запрос, а после завершения установки нажмите клавишу ВВОД, чтобы закрыть окно терминала.

Если вместо этого вы предпочитаете выполнять команду самостоятельно, можно щелкнуть "Копировать", чтобы скопировать команду терминала в буфер обмена.

Наконец, если вы хотите полностью пропустить этот шаг, вы по-прежнему можете присоединяться к сеансам совместной работы вручную, но вы не сможете присоединиться, открыв ссылку "пригласить" в браузере. обратите внимание, что вы всегда можете получить доступ к команде позже, нажав клавиши Ctrl + shift + p/Cmd + Shift + p и выбрав команду "Live Share: Launcher Setup".

См. также раздел

Возникли проблемы? Ознакомьтесь с разделом по устранению неполадок или отправьте отзыв.