AVR Sublime Text 插件

必需的条件

• 确保已安装 AVR 工具链 并设置为 PATH。您也可以使用 CrossPack 或任何其他可用的 AVR 工具链发行版。
• 在 Windows 中，您可能还需要安装 Make。 Windows 版 Make 是一个好选择。

通过软件包控制安装（推荐）

首先确保您已安装包控制插件（版本 2.0.0 或更高版本）。之后...

• 按 CTRL+SHIFT+P，输入 install 并按回车。
• 从列表中选择 AVR 并按回车。
• 完成。

手动安装

• 下载并解压，或使用 git clone，将插件下载到 Packages/AVR 文件夹。要访问名为 Packages 的文件夹，打开 Sublime Text 并选择 Preferences，Browse packages…
• 注意，插件不能通过 “Sublime Text 3 方式” 安装到 Installed Packages 文件夹。

使用方法

按 CTRL+SHIFT+P 以查看命令面板。接下来，输入 AVR 并选择要运行的命令。

创建/更新项目

• 提示选择 MCU 类型以及要创建新项目的目录。之后将询问模板。
• 完成后，您可以打开项目。为此，请选择 项目，打开项目…，浏览到项目文件夹并打开 SublimeAVR.sublime-project 文件。
• 如果指定项目目录已经包含 SublimeAVR.sublime-project，则应用更新。其他文件不被修改。

注意

在 Linux 中，SublimeClang 需要几个额外步骤才能工作。创建您的第一个项目后，打开命令行并切换到 SublimeClang 插件文件夹。您需要将 libclang.so 放入 internals 文件夹中。

locate libclang.so
ln -s [location] internals/libclang.so

如果未找到 libclang.so，请通过您的 Linux 发行版的软件包管理器进行安装。例如，在 Debian 中使用 aptitude

sudo aptitude install libclang-dev

最后需要构建 libcache.so

mkdir -p src/build
cd src/build
cmake ..
make

快捷键

• CTRL+B 构建项目
• ALT+D ALT+D 转到当前光标位置下定义的位置
• ALT+D ALT+I 转到当前光标位置下实现的代码
• ALT+D ALT+B 从定义或实现返回之前的位置

设置

要编辑插件的设置，请选择偏好设置，包设置，AVR。如果您不想改变默认设置，可以将这些设置复制并粘贴到用户侧进行编辑。

• c_std 和 cpp_std：创建项目时使用的 C 和 C++ 标准。这些设置影响保存到 SublimeAVR.sublime-project 文件中的预处理器定义宏。
• optimize：编译器优化级别。它也会影响预处理器定义宏。
• path：项目路径环境变量将由这个路径前缀。
• workdir：新项目的默认文件夹（又称工作区）。

模板

模板是来自插件文件夹 templates/ 的 zip 文件。您也可以将自定义模板文件放在那里并通过插件使用它们。参考基本模板，应该包含在这个插件中。如果您有一个好的 通用 模板，例如 Arduino，我乐意将其合并到插件中。

故障排除

1. 在尝试构建时，SublimeText 报错 解码错误 - 输出不是 utf-8

打开您的 SublimeAVR.sublime-project 项目文件，并在 build_systems 字典中添加以下新设置 - 例如，在 selector 设置之后
“ "encoding": “cp1252”

## License

This SublimeAVR Sublime Text plug-in is licensed under the MIT license:

版权所有 © 2014 Kim Blomqvist, kblomqvist.github.io

任何人免费获得此软件及其相关文档副本（“软件”）的副本后，均有权在不受限制地处理该软件，包括但没有限制地使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向软件提供方提供软件的人员这样做，前提是同意以下条件

上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。

软件按“原样”提供，不做任何明示或暗示的保证，包括但不限于适销性、适用于特定目的和不侵犯知识产权的保证。在任何情况下，作者或版权所有者不对任何索赔、损害或其他责任承担任何责任，无论是根据合同、侵权或其他原因提起的诉讼、损害或其他责任，是否因软件或使用或操作软件而起、涉及或与其相关。

The plug-in is derived from [Aery32 Sublime Text plug-in](https://github.com/aery32/sublime-aery32), which is licensed under the new BSD license:

版权所有 © 2012-2013，Muiku Oy
版权所有。

在满足以下条件下，可以重新分发和使用源代码和二进制代码，无论是否修改

• 源代码的分发必须保留上述版权声明、本条件清单和以下免责声明。

• 二进制代码的分发必须以文档和/或其他材料的形式重现上述版权声明、本条件清单和以下免责声明。

• 未经 Muiku Oy 或其贡献者的事先书面许可，不得使用 Muiku Oy 或其贡献者的名称来认可或推广由此软件衍生出的产品。

本软件由版权所有者和贡献者提供，按“原样”提供，不提供任何明示或暗示的保证，包括但不限于对适销性和特定用途适用性的暗示保证。在任何情况下，版权所有者或贡献者对任何直接、间接、偶然、特殊、示范性或后果性的损害（包括但不限于替代货物或服务的购买；使用、数据或利润的损失；或业务中断）都不承担责任，无论这种损害是根据什么理论、合同、严格责任还是侵权（包括疏忽或不作为）引起的，即使被告知了此类损害的可能性。

## Third party Packages used

SublimeAVR plug-in is dependent of [SublimeClang](https://github.com/quarnster/SublimeClang) plug-in. This dependent plug-in will be installed automatically by the SublimeAVR plug-in if needed. If you decided to pre-install SublimeClang, SublimeAVR will notice this and will not overwrite or modify your installation.

SublimeClang is licensed under the zlib:

版权所有© 2011-2012 Fredrik Ehnbom

本软件以“原样”提供，不提供任何明示或暗示的保证。在任何情况下，作者不对使用本软件产生的任何损害承担任何责任。

任何人都可以出于任何目的使用本软件，包括商业应用，并且可以自由修改和重新分发它，但须遵守以下限制

1. 本软件的来源不得被错误地表述；你不可以声称是原始软件的作者。如果你在本产品中使用本软件，产品文档中的致谢将受到欣赏，但不是必须的。

2. 修改后的源代码版本必须清楚地标记为修改版本，并且不得被错误地表述为原始软件。

3. 本声明不得从任何源分发中删除或更改。