移远面板脚手架

此脚手架提供面板创建、面板打包、脚手架升级等一站式服务。

1、安装脚手架

打开命令行终端，执行以下命令安装脚手架。若提示您未安装npm，请先根据React Native官网提示搭建环境。

npm i @quec/panel-cli -g

2、创建面板

执行以下命令创建面板。

quec-panel-cli create QuecPanelDemo

面板项目创建成功后即可进行业务开发，注意在开发过程中请谨慎使用依赖原生能力的React Native三方组件，否则可能会导致面板异常。

3、开发面板

执行以下命令安装面板依赖。

yarn

若未安装yarn，执行npm install --global yarn。

执行以下命令进行面板调试运行。

yarn start --reset-cache

4、打包面板

执行以下命令打包面板。

quec-panel-cli package /users/name/panel/QuecPanelDemo 1.0.0

注意：/users/name/panel/QuecPanelDemo对应面板的绝对路径。

5、升级脚手架

执行以下命令升级脚手架。

quec-panel-cli upgrade

6、其它

执行以下命令查询帮助。

quec-panel-cli --help

7、常见问题

7.1、面板开发过程中如何调试？

请阅读面板调试流程。

7.2、面板开发过程中如何使用App能力？

面板工程package.json中依赖了@quec一系列组件，请先阅读相关API注释后使用。

7.3、面板多语言如何调试？

目前面板工程使用产品多语言和物模型多语言两种形式组合，其中产品多语言需要在开发前尽量收集进行 excel归档 并加入移远IoT设备连接服务支撑QQ群（群号：832051178）询问，我们会协助您上传；物模型多语言可以在开发者中心上传，具体上传路径为开发者中心 → ”产品管理“ → 具体产品 → ”产品配置“ → ”多语言配置“ → ”物模型“；开发过程中可以直接使用 i18n('languageCode') 进行编码即可调试。

7.4、面板打包过程中出现中断怎么办？

如果出现以下警告，说明面板的组件依赖版本和App的依赖版本不一致，请自行判断是否兼容，尽量保持版本一致。

中断流程属于正常现象，可以手动编辑 QuecPanelDemo/out/android/quec-dependencies.json 和 QuecPanelDemo/out/iOS/quec-dependencies.json 中的内容（json文件中皆是面板所依赖的使用原生能力的React Native三方库），提高后续面板上传成功率。

在编辑过后，直接回车即压缩面板包，会在 QuecPanelDemo/out/android/ 和 QuecPanelDemo/out/iOS/ 目录下生成.tar.gz后缀的文件，将该文件发至移远IoT设备连接服务支撑QQ群（群号：832051178），我们将协助您上传面板，上传完成即可在App中体验。

7.5、面板线上崩溃问题如何跟踪？

如果在App打开面板时出现以上截图，说明面板存在崩溃问题，可以在执行面板打包指令后，查找*QuecPanelDemo/out/*目录下的两个以.bundle.map为后缀的文件，将该文件发至移远IoT设备连接服务支撑QQ群（群号：832051178），再上传App日志（“个人中心” → “关于我们”），我们会将崩溃堆栈反馈给您，协助定位问题。