MonkeyC

这是一个用于 Sublime Text 的 MonkeyC 语言定义和插件。MonkeyC 是由 Garmin 开发的一个语言，用于 ConnectIQ 平台，该平台运行在许多他们的设备上，如智能手表。

当你下载并设置 Connect IQ SDK 时，此插件还允许你构建 Connect IQ 项目，模拟和测试它们，并为发布和上传到 Connect IQ 商店打包。

文件扩展名： .mc

安装

1. 使用 Package Control，安装 “MonkeyC”

或者。

1. 在计算机上打开 Sublime Text 的包文件夹
2. 克隆此存储库

配置

安装完成后，你应该转到 首选项 > 包设置 > MonkeyC > 设置 并填入你的 Connect IQ SDK 路径（如果尚未下载，请下载）。并填入开发密钥的路径。如果你没有密钥，只想生成一个，你可以使用 工具 > MonkeyC > 生成开发者密钥（或从命令面板选择“MonkeyC: 生成开发者密钥”）来由插件生成一个，并为密钥路径进行更新。

你可以在每个项目中覆盖这些设置，在你的 .sublime-project 文件中添加一个顶级密钥（monkeyc），其外观如下

{
    "folders": [ ... ],
    "monkeyc": {
        "sdk": "/path/to/other/SDK",
        "key": "~/specific/key/for/project"
    }
}

特性

编辑

• 语法高亮：包括为 Toybox 命名空间中的 CIQ 模块提供特殊颜色。包含对 .jungle 文件的高级语法高亮。

• 自动完成：包括对语言关键字（如 instanceof、break）以及 module、class 等 的完整代码片段。在 jungle 文件中自动完成设备名称、修饰符和语言。

• 注释切换：选择一些行，然后按 Ctrl-/ 来切换注释的开/关。在 .mc 和 .jungle 文件中都有效。（使用 Ctrl-Shift-/ 进行块注释）
• 跳转符号：将模块、类和函数名称添加到Sublime符号列表中，以及(:注释)。按Ctrl-r搜索当前文件中的符号，或按Ctrl-Shift-r在项目范围内搜索符号。

关联SDK时的构建

• 编译：您可以编译连接iq应用程序（应用程序、表盘、数据字段）和桶（模块）。您可以使用Sublime构建系统（ctrl-b或命令面板：“MonkeyC：构建…”）
• 模拟：插件可以为您启动并连接到模拟器。（“MonkeyC：模拟”）
• 测试：运行断言（通过模拟器）和单元测试，类似于来自官方Eclipse插件的“运行无恶”插件。（“MonkeyC：测试”——这将使用-t测试标志重新编译您的项目，并使用带有-t测试标志的模拟器运行）
• 打包：编译一个准备上传和发布到Connect IQ商店的.iq应用程序（“MonkeyC：为发布打包”。这将删除调试和测试信息，包括任何:release标签）
• 侧载：为设备构建，以在本地上将其侧载到设备（命令面板中的“MonkeyC：为设备构建”）
• 密钥生成：没有开发者密钥？转到工具 > MonkeyC > 生成开发者密钥（或命令面板）现在就有了！（使用openssl创建RSA密钥，格式正确）
• 应用ID生成：每个Connect IQ应用需要一个特殊的ID（UUID）。插件可以为您生成随机UUID，并自动更新您的manifest.xml

如果您想自定义任何这些操作或将其设置为快捷键，它们都可以作为Sublime命令使用

monkey_build

编译项目。接受以下参数

• do 字符串（可选）："release"、"test"或"custom"。
  • release将-r -e标志应用到编译器，并将默认文件扩展名设置为.iq
  • test为应用程序应用-t标志。对于桶，它运行barreltest命令来运行单元测试
  • custom在运行之前提示用户使用命令，允许编辑
• name 字符串（可选）：生成的应用程序的文件名。默认为项目文件夹名
• device 字符串（可选）：将-d <device>作为编译器选项添加。使用字符串"prompt"让插件每次都提示您选择设备（基于您的manifest.xml文件中的支持设备）
• sdk 字符串（可选）：将-s <sdk>作为编译器选项添加以针对SDK进行编译。使用字符串"prompt"让插件确定给定设备的支持SDK目标（需要设备）
• flags 列表（可选）：您希望指定的任何其他标志或命令行参数。例如，使用运行简单编译的发布标志（禁用断言，调试信息）的run_command("monkey_build",{"flags":["-r"]})

monkey_simulate

运行Connect IQ模拟器。默认情况下触发用于模拟设备的monkey_build。接受以下参数

• device 字符串必需：要在其上进行模拟的设备。使用字符串“prompt”让插件每次都提示您选择设备（基于您的manifest.xml文件中的列表）。
• tests 布尔值（可选）：如果为true，则在项目中运行单元测试。断言始终运行，除非是发布构建。

monkey_generate

小型助手创建器。像开发者密钥或应用程序ID。接受以下参数

• gen 字符串必需：key创建开发者密钥，并使用它更新您的设置。uuid创建新的应用程序ID，并使用它更新您的manifest.xml

版本

3.1.0

添加SDK集成。编译、模拟和运行单元测试。有关详细信息，请参阅发行说明。

3.0.0

主要的语法规则彻底更新。包括自动补全、代码片段、文件语法（jungle file syntax）、跳转到符号（模块、类、函数名称以及注解）、注释切换（Ctl-/）、以及更好的颜色和插件支持。请参阅发布说明以获取详细信息。

2.1.0

更新包括Connect IQ 3.0.0（beta）版本中的新包

2.0.0

更新包括（一些？大部分？）至SDK 2.4.4的编程语言特性

1.0.0

初次发布，包含至SDK 1.2.5的大部分编程语言特性

Sublime Text 2

这个包目前不支持在ST2上使用，因为它使用了.sublime-syntax文件，这是ST3中的一个新特性。

贡献

请使用这个仓库的GitHub issues页面来提出请求、报告错误，以及在开始发起pull request之前进行工作计划。

这个仓库和代码与Garmin没有任何形式的合作或支持。MonkeyC是Garmin开发和推出的产品及编程语言。