Linux 安装详细信息
Linux 环境具有很强的可变性,具有大量桌面环境和分配,使用起来比较复杂。 如果继续使用受支持的 Ubuntu Desktop(16.04 及更高版本)、CentOS 7 或 Fedora Workstation(27 及更高版本)版本并仅使用 VS Code 正式分发版,你会发现过程很简单。 但是,如果使用非标准配置或下游分发版,可能会遇到一些问题。 本文档提供了一些有关要求的信息和一些故障排除详细信息,即使你的配置仅受社区支持,它们也可能帮助你启动和运行。 注意,Live Share 仅支持 64 位 Linux。
VS Code OSS 问题
Arch Linux/Manjaro 用户:使用 visual-studio-bin AUR 包来避免此问题。
作为 VS Code OSS 的 Vanilla 版本或修改版本的 Visual Studio Code 包在 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
中。 如果成功,则无需执行任何操作。
在某些情况下,分发版不支持此位置,或者需要调整才能将其与 Vanilla 安装一起使用。 在这些情况下,Live Share 回退到改为使用 /usr/local/share
。 因此,系统可能提示输入你的管理员 (sudo) 密码以完成安装过程。 随即出现一个终端窗口,显示将要安装浏览器启动器的位置。 只需在出现提示时输入你的密码,并在安装完成后按 Enter 即可关闭该终端窗口。
如果希望改为自己运行命令,可以单击“改为复制”,改为将终端命令复制到剪贴板。
最后,如果选择完全跳过此步骤,仍然可以手动加入协作会话,但将无法通过在浏览器中打开邀请链接来加入。 注意,以后可以随时再次访问该命令,方法是按 Ctrl+Shift+P/Cmd+Shift+P 并选择“Live Share:启动器设置”命令。