From 8cb951bc32797721bbc6c9bb3ec8b39d18f00bb8 Mon Sep 17 00:00:00 2001
From: handongxun <handongxun@dcloud.io>
Date: Wed, 18 Mar 2020 16:23:37 +0800
Subject: [PATCH] add quickapp doc

---
 quickapp.md | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 quickapp.md

diff --git a/quickapp.md b/quickapp.md
new file mode 100644
index 000000000..29b26004c
--- /dev/null
+++ b/quickapp.md
@@ -0,0 +1,71 @@
+### 快应用适配教程
+
+
+#### 准备
+
+1.安装 [快应用调试器](https://statres.quickapp.cn/quickapp/quickapp/201806/file/quickapp_debugger.apk)
+
+2.打开快应用调试器，下载平台（快应用预览版：版本号1060）
+
+
+#### 搭建
+
+1.创建 `hello uni-app` 工程
+```
+vue create -p dcloudio/uni-preset-vue#alpha my-qa-project -n
+```
+
+2.生成证书 `certificate.pem` 和 `private.pem`：到目录 `src/sign/debug/`
+```
+openssl req -newkey rsa:2048 -nodes -keyout private.pem -x509 -days 3650 -out certificate.pem
+```
+
+3.编译快应用 `rpk`
+```
+npm run dev:quickapp
+```
+
+4.开启debug在线更新服务
+```
+npm run serve:quickapp
+```
+
+5.打开快应用调试器，扫码安装或右上角设置服务器地址(注意带上`http://`，关闭USB调试可看到扫码)
+
+6.修改代码后，会主动通知调试器更新，或者手动点击在线更新（调试可以点击右下角开始调试）
+
+
+#### 开发调试代码
+
+1.仓库 `uni-app(quickapp branch)` [https://github.com/dcloudio/uni-app/tree/quickapp](https://github.com/dcloudio/uni-app/tree/quickapp)
+
+2.目录说明：
+```
+`src/platforms/quickapp/service/api` 平台的接口实现（方案同h5，app-plus）
+`src/platforms/quickapp/view/components` 平台的组件实现（easycom格式，目录名与文件名一致）
+`packages/uni-quickapp/lib/compiler-module` 编译阶段标签转换之类逻辑
+`packages/uni-quickapp/lib/polyfill.css` 全局样式差异代码
+`packages/uni-quickapp/lib/manifest` manifest.json的生成逻辑
+```
+
+3.编译 (输出目录`packages/uni-quickapp`)
+```
+npm run build:quickapp
+```
+
+4.可以选择手动替换到自己测试工程的`@dcloudio/uni-quickapp`里边,也可以考虑自己npm link本地`uni-quickapp`包（需要考虑三方依赖）
+
+
+#### 包名配置
+```
+项目 manifest.json
+{
+    "quickapp" : {
+        "package": "com.example.demo"
+    }
+}
+```
+
+注意：
+hello uni-app使用了px单位，在快应用里等同于rpx，故页面显示异常，非调试ui阶段，
+可以自己修改manifest.json->quickapp->config->designWidth=自己手头设备的逻辑像素，如360
-- 
GitLab