近期公司需要开发一款使用移动端设备通过蓝牙控制硬件设备的系统。因为公司没有专业开发手机APP的人员，所以技术选型为混合开发，也就是通过uniapp技术进行开发。

        到目前为止，开发了5天，APP的核心功能已经基本完成并已生成安装包进行测试。本人之前没有做过这方面的开发，写这个文档的目的就是记录下从入门以来的各种操作步骤，防止遗忘。另外，如果能给马上或已经入坑的码友提供一个避坑指南，那也是最好不过了。

        入门文档内容主要包括：1开发前准备；2程序开发；3打包和建议；

        这篇文档主要包含开发前的准备，后续内容将在未来陆续上线。

1、开发前准备

        个人认为，开发前需要准备三个方面，手机运行设置、开发工具和浏览参考文档。

        1.1 手机运行设置

        程序写好后要进行测试，因为公司项目是基于蓝牙进行功能操作，所以建议程序最好跑在真实的手机设备。同时，为方便调试和控制台输出显示，要将手机与pc进行连线并在手机上进行开发模式设置。步骤按照下面的说明进行：

        开始前先不要用数据线连接pc。

        首先要激活安卓系统的开发者模式。具体操作步骤是，打开“设置”-》“系统管理”-》“关于手机”菜单项，进入后找到“软件版本号”（注意：不同品牌手机进入方式和显示菜单名称都不太一样），连续双击4次“软件版本号”（次数也会与手机品牌和系统版本有区别），直到屏幕显示“已打开开发者模式”。如果之前已经打开，双击第1次时，屏幕上会提示“当前已处于开发者模式”。

        系统打开开发者模式后，在“设置”-》“系统管理”中会比之前（打开开发者模式前）多显示一个“开发者选项”菜单项。点击该菜单项。

        进入“开发者选项”菜单项后，分别找到“开发者选项”和“USB调试”，点击他们将这两项激活。激活时，系统会提示“是否允许。。”字样的选择框，都选择“确定”按钮。

        用连接线连接手机和pc。手机会提示如下图选择框：

        选择“允许”。但是，不要勾选“一律允许使用这台计算机进行调试”复选框。如果勾选，则后续手机断开与pc连接后，再次连接，会发现HBuilderX认不出来手机，自然也就没办法进行调试了。本人因为这个问题导致一天的上午3个小时不能开发，都在解决这个问题。

        当然，不勾选带来的问题就是每次连接，手机都会提示这个选择框。相比pc认不出手机，这点麻烦都不叫事。如果没有弹出这个选择框，可以断开连接线，再次重新连接。如果重新连接还不能显示，本人最终的解决方式就是修改连线之后pc处理方式，也就是在手机连接pc的状态下，在手机中的“只充电”和“传输文件”状态之间进行切换。本人试过的几台手机均能通过以上方式连接到pc并能在开发环境中识别出来手机设备。

         1.2 开发工具

        对于采用UNI-APP，开发工具自然选用HBuilderX，链接地址是：

        https://www.dcloud.io/hbuilderx.html

        打开地址后，点击download按钮。由于本人使用Windows系统，所以在弹出的窗口里，选择对应Windows的“APP开发版”，包大小在262M左右，进行下载。

        安装包下载后，因为是绿色的，不需要安装，所以直接解压缩就可以。解压后，双击HBuilderX.exe文件即可打开开发环境。

        1.3 参考文档

        跟购买家用电器一样，开箱之后最重要的事就是看使用手册。使用手册能告诉你很多使用这款产品必须要了解和掌握的内容。HBuilderX的使用手册在如下链接：

        https://hx.dcloud.net.cn/

        使用说明手册里包含的内容非常多。包含ide的使用、插件的开发和uni各接口的说明等等，可以根据需要进行学习浏览。