Yo Code - 扩展生成器

我们编写了一个Yeoman 生成器来帮助您开始。

先决条件

你需要的节点。在您的$PATH中安装并可用js。Node.js安装包括npm, Node.js包管理器，它将用于安装扩展生成器。

安装生成器

从命令提示符安装Yeoman和VS Code扩展生成器:

npm install -g yo generator-code

运行你代码

Yeoman生成器将指导您完成创建自定义或扩展所需的步骤，并提示您输入所需的信息。

要启动生成器，在命令提示符中输入以下命令:

yo code

生成器的选择

生成器可以为新扩展创建扩展框架，也可以根据现有的TextMate定义文件为语言、主题或片段创建现成的扩展。

新建扩展(TypeScript)

创建一个实现“hello world”命令的扩展框架。将此作为您自己的扩展的起点。

• 提示输入扩展标识符，并将在当前目录中创建该名称的文件夹。
• 创建带有源、测试和输出文件夹的基本文件夹结构。
• 模板输出package.json文件和扩展名主文件。
• 设置launch.json和tasks.json，以便F5编译和运行您的扩展并附加调试器。
• 可以选择设置Git存储库。

创建之后，在创建的文件夹上打开VS代码。该文件夹包含一个文件vsc-extension-quickstart.md，作为接下来步骤的快速指南。这个扩展的设置是为了让你得到扩展API的智能感知。

新建扩展(JavaScript)

与新建扩展(TypeScript)相同，但是JavaScript。这个扩展的设置是为了让你得到扩展API的智能感知。

新建颜色主题

创建一个能提供新颜色主题的扩展。您可以基于现有的TextMate颜色主题创建主题，或者从头创建新主题。

• 如果您计划使用 Developer: Generate Color Theme From Current Settings 命令在您的设置中使用自定义颜色创建主题(推荐)，那么从新的扩展开始。
• 以TextMate颜色主题开始，以现有的主题(如.tmtheme)开始。

生成器将:

• 提示输入颜色主题名称以及颜色基础主题(亮或暗)。
• 提示输入扩展标识符，并将在当前目录中创建该名称的文件夹。

创建之后，在创建的文件夹上打开VS Code并运行扩展来测试新主题。查看vsc-extension-quickstart.md。下面是一个快速指南。

新语言支持

创建一个扩展，该扩展使用着色器提供语言。

• 提示输入现有TextMate语言文件(.tmLanguage, .plist or .json)的位置(URL或文件路径)。此文件将导入新扩展名。要开始一个新的语法，您可以通过传递一个空的名称来跳过这个。
• 提示输入扩展标识符，并将在当前目录中创建该名称的文件夹。

创建好后，在创建的文件夹上打开VS代码并运行扩展来测试着色。查看vsc-extension-quickstart.md以了解接下来的步骤。查看已经创建的语言配置文件，并定义配置选项，比如语言使用的注释和括号。

新建代码片段

创建提供新代码片段的扩展。

• 提示输入包含TextMate片段(.tmsnippet)或Sublime片段(.sublime-snippet)的文件夹位置。这些文件被转换为VS Code片段文件。
• 提示输入这些片段将被激活的语言。
• 提示输入扩展标识符，并将在当前目录中创建该名称的文件夹。

创建之后，在创建的文件夹上打开VS Code并运行扩展来测试代码片段。查看vsc-extension-quickstart.md。接下来的步骤。

新建扩展包

创建一个扩展，该扩展使用您最喜欢的扩展提供一个新的扩展包。

• 提示将已安装的扩展添加到扩展包。
• 提示输入扩展标识符，并将在当前目录中创建该名称的文件夹。
• 检查包中的扩展依赖关系。发布扩展包之前的json文件。

创建好后，在创建的文件夹上打开VS代码并运行扩展来测试扩展包。查看vsc-extension-quickstart.md接下来的步骤。

你的扩展文件夹

要加载扩展，需要将文件复制到VS Code扩展文件夹.vscode/extensions。根据平台的不同，它位于以下文件夹中:

• Windows %USERPROFILE%\.vscode\extensions
• macOS ~/.vscode/extensions
• Linux ~/.vscode/extensions

如果每次VS Code运行时都要加载扩展名，请将项目复制到.vscode/extensions下的新文件夹中(“侧加载”)。例如:~/.vscode/extensions/myextension。

下一个步骤

发布工具-学习如何发布你的扩展到VS Code市场。
Hello World—尝试“Hello World”演练来构建您的第一个扩展。
其他扩展示例—查看我们的示例扩展项目列表。

常见问题

yo代码生成器不响应Windows 10上的箭头键
尝试用yo启动Yeoman生成器，然后选择代码生成器。

如果箭头键仍然没有响应，试着从一个升高的外壳启动Yeoman。为此，右键单击shell并选择Run as administrator。