基于Visual Studio Code 的佳明穿戴设备APP开发平台的搭建

本文以图文方式详细介绍了基于Visual Studio Code软件的佳明穿戴设备APP开发平台的搭建步骤、环境变量设置方法以及平台运行环境的设置等，为佳明穿戴设备APP的开发者提供了详尽的教程和参考资料。 

        Garmin Fenix 5x手表已经用了好几年了，平时的运动项目主要是慢跑和步行，这款手表记录了很多信息，对提高运动效率和成绩还是有一定的帮助。最近心血来潮，想为自已的Garmin Fenix 5x定制本人专用的表盘APP，让它看起来个性十足、与众不同，并且只显示自已关心的运动参数和信息。做这件事首先要搭建Garmin Fenix 5x表盘APP的开发平台，在Garmin developer上学习了几天，终于把平台搭好了，现在分享下平台的搭建过程，以方便同好的伙伴们。这个平台不仅适用于Garmin Fenix 5x手表表盘的开发，它实际上能用于几乎所有的Garmin或穿戴设备APP的开发，所以如果你对开发Garmin相关设备有兴趣，那么这篇文章的内容就是开发工作的基础了。

        开发佳明设备的APP必须要下载和安装Garmin ConnectIQ SDK，这个是佳明官方发布的佳明穿戴设备软件开发工具包，它封装了佳明穿戴设备常用的一些功能代码，以方便开发者调用，在开发工作中使用SDK可以事半功倍。Garmin ConnectIQ SDK以前在Eclipse上运行，这次在我搭建Garmin 开发平台时发现，佳明官方推荐的开发平台已经变成了Visual Studio Code，在搭建开发平台的过程中，佳明官方的步骤有时会难以理解，下面我就把自已的搭建过程分享给大家。

一、下载和安装 Garmin ConnectIQ SDK manager

        这个SDK管理器可以自动地更新佳明穿戴设备的版本，使你的开发平台总是能适用于佳明最新的设 备，它是一个压缩文件包，在这里下载：Get the SDK | Connect IQ | Garmin Developers

        可以根据你所用的操作系统选择合适的版本下载，我用的windows平台的，解压后运行sdkmanager.exe出现的画面：

选accept并点ok后：

        这个时候需要Garmin的developer account，直接用佳明的注册账号也能行，点Login后：

在这里输入佳明注册的账号和密码，然后：

点Next，出现的画面是：

        在这个信息框里，如果希望SDK自动安装更新，就选第1项，我是选的第一项，点Next后：

         这个画面的选项是问是不是自动地下载新的SDK，我选的自动，然后点Next:

        这次是问是否自动更新设备库，我的选项如图，然后点了Finish:

这时出现的是开发平台适用的佳明设备下载的列表，点OK：

        这个列表是SDK各版本的下载选项，如果选了下载，就会逐一下载，每个版本下载完成后会提问：是否把刚下载完成的SDK版本设成当前使用的SDK？这个根据使用的情况选择就行了：选个最新的SDK版本下载，并设为当前的SDK。

        以上四张图是当前的SDK里所包含的穿戴设备的种类、型号的下载列表。

        以上内容下载需要点时间，下载完成后关闭SDK manager就行了。

         二、安装Virual Studio Code

        在安装Virual Studio Code之前，需要安装Java，java for windows的下载地址在这里：https://java.com/en/download/，下载后直接安装就行，记好安装的位置，后面的设置需要用到。下载Visual Studio Code的地址是：Setting up Visual Studio Code，根据你自已操作系统选择合适版本下载，下载后执行exe文件安装过程显示信息如下面的图：

至此，Visual Studio Code安装完毕。

        三、安装和配置Monkey C

        启动VSC(Visual Studio Code)，然后在顶部菜单的“查看”选项下的“扩展”找到“Monkey C Monkey C Language Support Garmin”并点击它右下角的“安装”按钮进行安装操作。

        Monkey C安装完成后需要重启VSC，重启后按Ctrl+Shift+P(Mac系统按Command+Shift+P)打开命令面板，并输入“Verify Installation”，选择Monkey C:Verify Installation，验证安装Monkey C:

        这个操作完成后还要生成编译Connect IQ需要的Developer key，在命令面板中输入Generate a developer key，选择“Monkey C: Generate a Developer key”，并选好存放密钥的位置，值得注意的是，如果你原来在Eclipse或AS中使用的密钥不能在这里使用，需要重新生成。

        密钥生成后再来配置Monkey C运行环境，主要是指定Java的安装位置，在VSC中，选“查看”>“扩展”,在Monkey C项目的右下角点击齿轮图标，在弹出菜单中选择“扩展设置”，把Java的安装位置贴到Monkey C: Java Path下的空栏中：

        这个配置设定完成后，开发平台的基本构架已经形成了，然后是最后也是最重要的一步。

        四、Connect IQ SDK环境变量的设置

        这一步之所以重要是因为如果Connect IQ SDK环境变量设置不对模拟器就无法运行，开发者也就没法调制代码。

         首先要找到Connect IQ SDK所带的current-sdk.cfg文件的位置， 一般地它放在用户所在的AppData文件夹中，在我的计算机里，它在这个位置：“C:\Users\%用户名%\AppData\Roaming\Garmin\ConnectIQ”，两个“%”号之间是本机登录的用户名，找到current-sdk.cfg文件后，将其路径考贝到剪切板中，然后按win+r键，输入cmd命令，打开dos命令窗口， 在dos命令窗口中输入下面两条命令：

for /f usebackq %i in (%本机current-sdk.cfg文件的路径%\current-sdk.cfg) do set CIQ_HOME=%~pi

set PATH=%PATH%;%CIQ_HOME%\bin

上面两条命令执行界面如下图所示：

 

 如果想验证一下Connect IQ SDK的环境变量是否设置好了，可以在cmd的命令提示符窗口分别输入connectiq，monkeyc，monkeydo命令，出现的结果如下：

则说明Connect IQ SDK的环境变量设置正确。

       实际上，经过作者尝试，可以按java环境变量的设置方法设置Connect IQ SDK的环境变量，那样使用时更方便。

        最后，在这个开发平台上设计了一个最简单的表盘，设计的过程如下：

        打开VSC，按Ctrl+Shift+P(Mac系统按Command+Shift+P)，在命令行输入“New Project”然后选择“Monkey C:New Project”:

在弹出的输入框里输入新建项目的名字：

名字确定后按回车键，出现项目类别选择菜单，我这里选的是“Watch Face”（表盘），而你可以选择你将要开发APP的类型：

确定APP的类型后再选择模板，表盘的模板有两种，我选择了第一种“Simple ”:

模板确定后再选择开发的APP支持的API level的最小值，在这里我选的是3.2.0：

再确定存放新建项目的位置后项目建立的过程就完成了，在项目初始化后能看到新项目自动地创建了下面的内容：

        为了检验这个开发平台搭建的是否成功，运行一下这个刚建的新项目，在没对新建项目进行任何编辑的情况下点击VSC下拉菜单中的“运行”后选择“以非调试模式运行”，在显示的设备列表中选择一款产品型号：

在选择fenix 5x plus后运行后的效果是这样的：

        说明这个基于Visual Studio Code的Garmin穿戴设备开发平台已经搭建成功，可以在上面进行开发工作啦。

         以上就是基于Virual Studio Code软件进行Garmin可穿戴设备APP开发平台搭建的全部过程， 希望本文对开发者有所帮助！