Сведения об установке 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 обнаружит проблему, которая может быть связана с отсутствием библиотек, вы увидите всплывающее уведомление с запросом разрешений на их установку.

Toast notification showing message that Linux pre-requisites are missing

При нажатии кнопки "Установить" появится окно терминала, в котором ос предложит ввести пароль администратора или корня (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 22.04 (64-разрядная версия) libssl1.1 <Нет>
Ubuntu Desktop 18.04 (64-разрядная версия) <Нет> <Нет>
Ubuntu Desktop 16.04 (64-разрядная версия) <Нет> <Нет>
Kubuntu 18.04 (64-разрядная версия) gnome-keyring desktop-file-utils <Нет>
Kubuntu 16.04 (64-разрядная версия) gnome-keyring desktop-file-utils <Нет>
Xubuntu 18.04 (64-разрядная версия) <Нет>
  • Убедитесь, что флажок "Запустить службы TLS при запуске" установлен на вкладке "Дополнительно" в разделе "Сеанс и запуск".
  • Если при входе возникают проблемы, установите seahorse, запустите "Пароли и ключи", убедитесь, что у вас есть клавиши Login и что ее можно разблокировать.
Xubuntu 16.04 (64-разрядная версия) <Нет>
  • Убедитесь, что флажок "Запустить службы TLS при запуске" установлен на вкладке "Дополнительно" в разделе "Сеанс и запуск".
  • Если при входе возникают проблемы, установите seahorse, запустите "Пароли и ключи", убедитесь, что у вас есть клавиши Login и что ее можно разблокировать.
Мята 19 Корица (64-разрядная) <Нет> <Нет>
Мята 18.3 Корица (64-разрядная) <Нет> <Нет>
Debian 10 (Buster) Testing (64-разрядная версия) Выпуск не стабильный, поэтому неизвестный.
Debian 9 GNOME Desktop (64-разрядная версия) <Нет>
  • Для использования сценария автоматической установки может потребоваться установить sudo и добавить пользователя в группу sudo.
Fedora Workstation 29 (64-разрядная версия) openssl-libs <Нет>
Fedora Workstation 28 (64-разрядная версия) <Нет> <Нет>
Fedora Workstation 27 (64-разрядная версия) <Нет> <Нет>
CentOS 7 GNOME Desktop (64-разрядная версия) <Нет> <Нет>

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

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

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

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

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

Distribution Работает? Ванильная установка отсутствующих библиотек Дополнительные действия
Arch Linux (64-разрядная версия) Да Возможны разные варианты. Возможные библиотеки: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xprop icu69
Manjaro 17.1 (64-разрядная версия) Да xorg-xprop liburcu icu69
openSuSE LEAP 15 KDE (64-разрядная версия) Да libopenssl1_0_0 gnome-keyring
  • Поддерживается скриптом установки необходимых компонентов.
Solus 3 (64-разрядная версия) Да xprop
Gentoo (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 в наложении jorgicio , как известно, работает.

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

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

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

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

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

Distribution .NET Core Reqs Учетные данные служба хранилища Reqs Reqs интеграции с браузером
Дистрибутивы 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 supported keyring — Kwallet не поддерживает libsecret) desktop-file-utils x11-utils
Дистрибутивы Debian 9 и подчиненные libssl1.0.2 libkrb5-3 zlib1g libicu57 libsecret-1-0 gnome-keyring (или libsecret supported keyring — Kwallet не поддерживает libsecret) desktop-file-utils x11-utils
RHL / CentOS/ Fedora openssl-libs krb5-libs zlib libicu Для Fedora также требуется openssl-libs libsecret gnome-keyring (или libsecret supported keyring — Kwallet не поддерживает libsecret) desktop-file-utils xprop
Alpine Linux openssl1.1 icu krb5 zlib libsecret gnome-keyring (или libsecret supported keyring — Kwallet не поддерживает libsecret) desktop-file-utils xprop

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

Debian / Ubuntu

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

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

sudo apt install libssl1.1 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 / RHL

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

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

проблемы VS Code OSS

Arch Linux/Manjaro Users: Используйте пакет AUR visual-studio-bin , чтобы избежать этой проблемы.

Пакеты 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-vsliveshare.vsliveshare, вы используете версию OSS с этой проблемой.

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

"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: программа установки запуска".

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

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