OpenHarmony实战-模拟器调试

模拟器调试使用说明
1、环境安装说明

1、Qt Creator安装
本工程基于QT Creator搭建，开发者使用前需要下载和安装QT Creator。

程序下载
地址：https://www.qt.io/offline-installers，安装程序较大，建议下载离线稳定版本。

程序安装
双击下载的Qt安装程序，按引导界面完成安装即可。

注意事项：
1. 注册安装界面
   可选择注册账号进行安装，或者断网安装跳过注册界面。
2. 选择组件界面。
   需勾选Qt x.x.x展开栏（这栏是为qt自动配置构建套件，如果漏选，开发者可后期在Qt控件中自行手动配置）和Developer and Designer Tools展开栏（这栏是编译器组件下载）都要勾选minGW组件（基于当前电脑操作系统选择32-bit还是64-bit）。
 

2、Git for windows安装
​ 为能在windows环境下使用git命令，开发者需安装Git for windows。

1.程序下载
2.地址：Git for Windows

3.程序安装
双击下载的安装程序，按引导界面完成安装即可。

4、打开工程
场景一：JS应用打开方式：
源码下载 建议在Linux下使用 repo 批量下载所涉及到的代码仓到windows盘符下，下载后在windows下打开工程。

// 初始化 repo
repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
// sync 所有相关仓
repo sync graphic_surface_lite arkui_ui_lite graphic_graphic_utils_lite window_window_manager_lite third_party_bounds_checking_function third_party_cJSON third_party_zlib third_party_freetype third_party_harfbuzz third_party_icu third_party_libjpeg-turbo third_party_libpng third_party_qrcodegen third_party_zlib commonlibrary_utils_lite ability_ability_lite third_party_jerryscript arkui_ace_engine_lite global_resource_management_lite

1. ​打开QT Creator
2. 点击菜单：文件—>打开文件或项目
3. 弹出的文件选择框中选择工程项目
4. 参考源码路径（请下载到windows本地，不要使用"\wsl$"路径映射）：
5. [源码工程目录]\foundation\arkui\arkui_ace_engine_lite\frameworks\tools\qt\simulator\simulator.pro。
6. 注意：第一次打开项目时，需要在Configure Project界面，kits列表中勾选minGW（仅勾选minGW）。
7. 点击configure project按钮加载工程。
8. 编译
9. 依次点击：构建—>编译项目，或者直接在项目树中右键，在右键菜单中选择重新构建即可。
10. 调试
11. 编译完成后，点击调试按钮即可运行调试。
12. 设置JS bundle路径
13. 项目第一次启动时，由于未配置JS Bundle路径，无法正常显示应用，需要开发者手动配置路径，配置后再次启动时会根据已配置信息显示应用。
14. 配置方法：点击界面下方JS Bundle目录选择按钮，选择JS Bundle所在目录，然后点击Start按钮即可启动。
15. 备注：JS Bundle可通过下载DevEco Studio创建应用后编译生成（编译生成的JSBundle路径：项目所在目录\entry\build\intermediates\res\debug\lite\assets\js\default），部分应用示例源码可从目录arkui_ace_engine_lite\frameworks\examples获取。JS应用开发可参考文档https://docs.openharmony.cn/pages/v3.1/zh-cn/device-dev/guide/device-camera-visual-overview.md。
16. 备注:

1、当前模拟器工程暂时只支持UI调试，不支持JS API，如果项目中使用了部分JS API，可能会导致应用无法正常显示。对JS API的支持会陆续增加完善，敬请期待。

场景二：C++ UI应用打开方式：
源码下载
如果使用Windows调试，建议不要使用"\wsl$"路径映射，下载到本地硬盘下。
下面为拉取UI模拟器最小代码仓的git命令。

git clone https://gitee.com/openharmony/arkui_ui_lite.git                        -b   master  foundation/arkui/ui_lite
git clone https://gitee.com/openharmony/graphic_graphic_utils_lite.git           -b   master  foundation/graphic/graphic_utils_lite
git clone https://gitee.com/openharmony/third_party_zlib.git                     -b   master  third_party/zlib
git clone https://gitee.com/openharmony/third_party_qrcodegen.git                -b   master  third_party/qrcodegen
git clone https://gitee.com/openharmony/third_party_libpng.git                   -b   master  third_party/libpng
git clone https://gitee.com/openharmony/third_party_libjpeg.git                  -b   master  third_party/libjpeg
git clone https://gitee.com/openharmony/third_party_icu.git                      -b   master  third_party/icu
git clone https://gitee.com/openharmony/third_party_harfbuzz.git                 -b   master  third_party/harfbuzz
git clone https://gitee.com/openharmony/third_party_freetype.git                 -b   master  third_party/freetype
git clone https://gitee.com/openharmony/third_party_bounds_checking_function.git -b   master  third_party/bounds_checking_function
git clone https://gitee.com/openharmony/third_party_cJSON.git                    -b   master  third_party/cJSON

1. 新建一个源码工程目录。
2.在新建目录按鼠标右键打开Git BashHere，复制粘贴上面命令到终端回车等待下载。或者在当前目录新建一个clone.bat文件，将上面命令复制保存，双击运行clone.bat，等待下载完成。
3.打开QT Creator
4.点击菜单：文件—>打开文件或项目

        弹出的文件选择框中选择工程项目
        点击configure project按钮加载工程。
5.UI Test应用运行入口

        展开项目树:

simulator
  |-UITest
    |-Sources
      |-main.cpp

6.编译
依次点击：构建—>编译项目，或者直接在项目树中右键，在右键菜单中选择重新构建即可。

7.调试
编译完成后，点击调试按钮即可运行调试