快应用常见问题 @2020~2021
快应用是移动互联网新型应用生态，与手机系统深度整合，为用户提供更加场景化的体验。具备传统 APP 完整的应用体验，但无需安装、即点即用。本文旨在汇聚快应用常见问题，包含调试器、IDE、以及引擎、登录、支付等，统一梳理、解答，从而更好服务快应用开发者。
备注：本文内容皆来自快应用常见问题网站，如果您有相关诉求，敬请关注 faq.quickapp.cn，将在此网站保持维护 & 更新 。
快应用调试器
调试器扫码安装提示安装失败？
有以下情况，会导致安装失败，请逐一检查下：
- （调试器）开启了 USB 调试：
- 您的手机是否与电脑用 USB 线连接；
- 是否在 IDE 终端已成功构建（
dist目录是否存在 [PackageName].debug.rpk）； - 开发者选项中的 USB 调试是否打开；
- （调试器）没有开启 USB 调试，扫码安装：
- 您的手机是否和电脑处于同一局域网；
- 是否在 IDE 终端已成功构建；
快应用预览版是用来做什么用的？
当您的手机系统尚未内置快应用运行平台，或您想在开发过程中，体验快应用尚未正式发布的新功能、新特性，您可以安装快应用预览版，在线下载地址，请参见资源下载。
快应用调试器，如何安装未发布应用（非局域网）？
您可以上传 RPK 至服务器，或者 Github，为具体地址生成二维码，使用调试器扫码即可（Github 路径后需加 ?raw=true 参数）。更加推荐的是：使用官方提供的「包管理平台」。您可一键上传 RPK 至包管理平台（公网），用调试器扫所生成的二维码，即可安装。更详尽的内容，可以参见快应用包管理平台使用说明。
真机调试，修改源码时，如何仅重新加载当前页，不重启应用？
开发调试时，如果每次修改保存，都回到首页，这对于其他页面调试，很不方便。自调试器 1020 版本及以上，增加了应用更新策略，使得更新 rpk 仅刷新当前页，而不用重启整个应用。具体设置方式：
在「快应用调试器」中选择设置 → 应用更新策略 → 仅刷新页面。更加详细的信息，请参见快应用调试器 1020 版发布。
快应用调试器，运行模式，是做什么用的？
运行模式是用来选择调试「快应用」，还是调试「卡片」；运行模式，选择“应用”是用于调试快应用，选择“卡片”是用于调试卡片。
手机调试器，如何调试第三方分享、推送等服务？
调试第三方分享，具体可参考官方文档说明，调试推送服务，具体可参考官方文档说明，以及各家厂商推送服务文档。
调试时手机息屏, 再次打开调试工具, console 被清空？
解决办法：将快应用调试器加入后台高耗电「白名单」；具体操作：设置 => 电池 => 后台高耗电，选择快应用调试器，把它打开即可。
可否关闭调试器自动弹出创建桌面方式？
可以。即通过设置 shortcut.systemPromptEnabled = false 来关掉；具体可参考官方文档说明。
快应用开发工具
快应用 IDE 都有哪些功能，哪儿能看到版本迭代信息？
快应用 IDE，是一款专为快应用开发设计的工具。使用它，可以根据模版，快速新建项目（快应用 & 卡片）；编辑代码，有完善的语法辅助、检测工具；支持模拟器和真机实时预览，开发调试；同时提供了一键提交 RPK 至包管理平台、官网，以及一键分享项目等功能。更详细内容，可参见文章——快应用开发工具入门介绍。关于 IDE 版本迭代信息，可以关注快应用博客 | IDE。
手机通过数据线连接电脑，而 IDE 未提示设备已连接?
- 打开手机
设置找到关于手机，向下滑动找到软件版本号，连续多次点击软件版本号直到提示“您已处于开发者模式”。 - 打开手机
设置找到开发者选项，向下滑动找到USB 调试并打开该选项。 - 重新插拔手机，手机上会弹出授权对话框，勾选“始终允许使用这台计算机进行调试”，点击
确定按钮；
点击 IDE 顶部 Debug 调试按钮开始调试，手机端快应用却没有运行起来?
- 打开手机
设置找到关于手机，向下滑动找到软件版本号，连续多次点击软件版本号直到提示“您已处于开发者模式”。 - 打开手机
设置找到开发者选项，向下滑动找到USB 调试并打开该选项。 - 重新插拔手机，手机上会弹出授权对话框，勾选“始终允许使用这台计算机进行调试”，点击
确定按钮。 - 确认手机设备已经连接，IDE 右侧预览界面头部
手机图标处于点亮状态； - 点击 IDE 顶部
hap``更新手机环境菜单，并在手机上按提示完成快应用预览版和快应用调试器的安装； - 打开手机
设置找到权限管理，将快应用预览版的存储、关联启动和后台弹出界面权限打开； - 打开手机
快应用调试器并将开启 USB 调试开关开启，此时会弹出授权对话框，点击始终允许按钮； - 重新点击
Debug 调试按钮开始调试；
编辑代码 Script 部分自动补全及悬浮提示不生效？
- 打开 IDE
首选项=>设置，选择工作区设置，找到扩展hap-language-features中的Extract Hap Types并勾选enable to import the latest types； - 退出并重新启动 IDE；
- 打开工程中的任意一个
.ux文件; - 查看工程目录下
node_modules是否生成类似@service.account.d.ts的文件，存在则表示：自动补全及悬浮提示可以正常使用了；
IDE 模拟器预览跟手机端效果不一致？
由于纯原生渲染与 Web 渲染存在的差异性，导致部分预览效果不一致。我们建议以手机端效果为准。备注说明：对 于 IDE 预览，有在持续与真机对齐；倘若您有发现有差异的部分，还请给予反馈，感谢。
快应用开发工具怎么调试元素样式？
- 基于模拟器调试：更新 IDE 至 3.3.0 版本以上；在 IDE 顶部导航栏，点击调试器 & 模拟器按钮🔘，使其处于激活态；在弹出的 DEVTOOLS 中，选中 UX 面板，即可开始调试元素。
- 基于真机调试：
- 基于 USB 调试：手机使用 USB 连接电脑；在 IDE 顶部导航栏，点击 USB 调试；在弹出的 Window 中，选中 Elements 面板，即可开始调试元素。
- 基于局域网调试：点击 IDE 预览区顶部
二维码小按钮，使用快应用调试器扫描所弹出的二维码；打开后回退至调试器，点击开始调试按钮🔘；在弹出的 Window 中，选中 Elements 面板，即可开始调试元素（确保手机跟电脑在同局域网）。
快应用开发工具怎么断点调试？
IDE 暂时还不具备这个功能（有考虑在后续迭代中，添加此功能，敬请期待），需要在 DevTools 面板进行断点调试。
快应用如何打出带签名的正式包？
IDE 正常构建是 Debug 包；顶部导航栏右侧，点击「打包」、「上传」所构建的包，即为 release 带签名的正式包（如果本地没有签名，会提示让先新建签名）。
IDE 上点 USB 调试无法打开调试器面板？
清理手机中调试器的进程，再点 USB 调试按钮，或者使用快捷键 F5；这是一个已知问题，在后期版本中，会联合调试器一起排查解决。
点击 IDE USB 按钮开始调试，手机端没有运行起来？
- 确认手机设备已经连接，IDE 右侧预览界面头部【手机】图标处于点亮状态
- 确认手机端【快应用预览版】和【快应用调试器】都安装成功，若未安装请按 IDE 的提示安装
- 打开手机【设置】找到【权限管理】，将【快应用预览版】的【存储】、【关联启动】和【后台弹出界面】权限打开
- 打开手机【快应用调试器】并将【开启 USB 调试】开关开启，此时会弹出授权对话框，点击【始终允许】按钮
- 重新点击 IDE USB调试 按钮 或者快捷键
F5开始调试
IDE 调试器 DEVTOOLS 区域，操作无任何响应？
引发此问题具体原因，仍需排查；您可有以下两种方法来解决：
- 在
代码区，点击鼠标右键； - 重新加载窗口（
Ctrl+ Shift + P,Reload Window）；
IDE 如何切换「中/英」文的设置？
点击 IDE 顶部导航栏，首选项（Preferences） => 选择语言（Select Language），选择想切换的语言即可。
您也可以基于快捷键 Ctrl Shift P 打开命令面板（Mac：Command Shift P），输入“language”，选择需要切换的语言即可。
快应用其他问题
快应用支持调起原生 APP 么？
功能上已经实现，但是大部分厂商审核是不允许的。目前支持的只有华为。调用方式，可以参考如何在快应用中打开原生应用？。
快应用可否直接跳转到微信？
可以通过第三方服务如分享，支付等唤醒微信。目前直接跳转到 app 的需求，暂时只有功能上的实现，但是大部分厂商审核，不会允许该功能上线，详见 router.push 打开原生应用。
哪里可以检索快应用开发常见问题？
快应用问题检索，有将快应用开发中，遇到的问题进行统一汇聚、整理；可以根据关键字，到该网站进行检索。
如果不能解决问题，可以前往快应用论坛发帖，或者加入快应用官方技术交流群（微信 OR QQ），<span class="hljs-meta">@技术弟</span>提出疑问，寻求解答。
快应用支付常见问题说明
在快应用第三方登录支付签名教程一文中，对如何创建第三方登录、支付签名，快应用登录，以及支付常见问题，做了详细解答。如有相关其他问题，欢迎留言评论。
能否使用 QQ、微信登陆以及支付功能？
可以，详见快应用开发文档第三方服务。不过联盟不同厂商，对接口的支持略有不同，具体可以查看每个接口中的支持明细，如微信登录，可参考支持明细。
快应用可否使基于 vue 进行开发？
自联盟引擎 1060+，开始支持使用 vue 开发快应用，具体可以参考官方文档：使用 Vue 开发快应用。提示：华为快应用平台，未集成 Vue 框架，因此不支持 Vue DSL 的运行。
快应用如何适配 menuBar？
适配注意事项：需保证快应用的一级页面必须开启 menuBar。具体步骤如下：
- 删除所有页面文件（
<span class="hljs-selector-class">.ux</span>或<span class="hljs-selector-class">.vue</span>后缀名）中onMenuPress生命周期的实现； - manifest.json 的
<span class="hljs-built_in">display</span>属性中，若不手动添加 menubarData 项，则默认为全部快应用页面打开 menuBar（推荐做法）； - 若有需要手动关闭 menuBar 的页面，在 manifest.json 的 display 属性下的 pages 子项，设置对应页面 key 值下 menuBarData 的 menubar 参数为 false；
更详尽的内容，请参见快应用文档之 menuBar 配置。
快应用是否支持使用 npm 上 js 库？
可以。理论上，如果该 js 库，不涉及 Dom 操作，快应用都支持，使用方式跟 Web 开发方式一致（如 crypto-js 等等）。
