| 1 | # hap-toolkit
|
| 2 |
|
| 3 | 快应用开发者工具
|
| 4 |
|
| 5 | ### 如何使用
|
| 6 |
|
| 7 | 1. 全局安装 hap-toolkit
|
| 8 |
|
| 9 | ```sh
|
| 10 | npm install -g hap-toolkit
|
| 11 | ```
|
| 12 |
|
| 13 | 2. 新建示例工程，方便开发者快速上手
|
| 14 |
|
| 15 | ```sh
|
| 16 | hap init `<project-name>`
|
| 17 | ```
|
| 18 |
|
| 19 | 3. 安装 npm 依赖
|
| 20 |
|
| 21 | ```sh
|
| 22 | cd `<project-name>`
|
| 23 | npm install
|
| 24 | ```
|
| 25 |
|
| 26 | 4. 构建项目
|
| 27 |
|
| 28 | ```sh
|
| 29 | npm run build
|
| 30 | npm run server
|
| 31 | ```
|
| 32 |
|
| 33 | 5. 其他命令（[请参考开发者文档](https://doc.quickapp.cn/)）
|
| 34 |
|
| 35 | ### 版本日志(详情请查看 CHANGELOG)
|
| 36 |
|
| 37 | #### [0.4.x]
|
| 38 |
|
| 39 | - 添加`--disable-stream-pack`参数用于禁用流式包（`build`,`release`,`watch`命令有效）
|
| 40 | - 支持自定义配置
|
| 41 | - 修复了 hap update --force 时 JS 报错的问题
|
| 42 |
|
| 43 | #### [0.3.x]
|
| 44 |
|
| 45 | - 1040 平台支持
|
| 46 | - 不再支持`node 6`，要求`node 8`以上版本
|
| 47 | - 不再创建备份文件
|
| 48 | - 新增`web`预览功能，打开服务`/preview`页面可使用浏览器预览快应用
|
| 49 | - 新增`hap preview`子命令，可直接预览`rpk`文件或解压的`rpk`文件目录（包括`build`目录）
|
| 50 | - 新增`hap view`子命令，可用于直接查看`rpk` 文件。详情可执行`hap view --help`查看
|
| 51 | - 监听模式增加监听`manifest.json`文件
|
| 52 |
|
| 53 | #### [0.2.x]
|
| 54 |
|
| 55 | - 支持分包
|
| 56 | - `chrome devtools` 升级到 66
|
| 57 | - 修复初始化模块的 elisnt 配置无效的问题
|
| 58 | - 优化错误栈信息
|
| 59 | - 修复`toolkit`误报使用`node`原生模块问题
|
| 60 |
|
| 61 | #### [0.1.x]
|
| 62 |
|
| 63 | - 项目 package.json 的依赖只有 hap-toolkit，移除了其他依赖
|
| 64 | - 支持 postcss 解析 css
|
| 65 | - 支持可以自定义属性 data-xxx
|
| 66 | - slot 可以作为 text 的子组件
|
| 67 | - WebSocket 支持 ArrayBuffer
|
| 68 | - 更新对部分新属性，新事件，新样式的支持
|
| 69 |
|
| 70 | ### 常见问题
|
| 71 |
|
| 72 | #### 一、从小于 0.0.38 版本升级
|
| 73 |
|
| 74 | 若 hap-toolkit 从 0.0.37 升级上来，有比较大的改动，其中需要注意的是：
|
| 75 |
|
| 76 | 1. 项目下面的 .babelrc 文件变更为 babel.config.js 文件。babel.config.js 内容如：
|
| 77 |
|
| 78 | ```
|
| 79 | module.exports = function(api) {
|
| 80 | api.cache(true)
|
| 81 | return {
|
| 82 | presets: ['@babel/preset-env'],
|
| 83 | plugins: ['@babel/plugin-transform-modules-commonjs'],
|
| 84 | babelrcRoots: ['.', 'node_modules']
|
| 85 | }
|
| 86 | }
|
| 87 | ```
|
| 88 |
|
| 89 | **.babelrc 文件需要删除。**
|
| 90 |
|
| 91 | 2. 项目的基础依赖只需要以下模块，package.json 里的 devDependencies 字段如：
|
| 92 |
|
| 93 | ```
|
| 94 | {
|
| 95 | "devDependencies": {
|
| 96 | "babel-eslint": "^10.0.1",
|
| 97 | "eslint": "^5.12.1",
|
| 98 | "eslint-plugin-hybrid": "0.0.5",
|
| 99 | "hap-toolkit": "^0.4.3"
|
| 100 | }
|
| 101 | }
|
| 102 | ```
|
| 103 |
|
| 104 | **修改后请将 node_modules 和 package-lock.json 删除，再重新安装依赖。**
|
| 105 |
|
| 106 | [反馈问题](https://github.com/quickappcn/issues/issues/new/choose)
|
| 107 | [查看版本更新历史](https://bbs.quickapp.cn/forum.php?mod=viewthread&tid=935)
|