uni-app x 纯原生跨平台 APP 项目创建 与 Android 安卓调试

[xuxiaowei]

说明

• HBuilderX 某些操作可能要安装插件，HBuilderX 软件会自动提示，根据提示点击即可

HBuilderX

下载

• HBuilderX-高效极客技巧

账户注册

• 使用邮箱注册：账号中心
• 使用手机号注册：账号中心

Android Studio

• 中文官网：https://developer.android.com/?hl=zh-cn
• 官网下载页面：https://developer.android.com/studio?hl=zh-cn
• 使用 JetBrains toolbox 下载安装：JetBrains Toolbox App: Manage Your Tools with Ease

[xuxiaowei]

创建 uni-app x 项目

1. 文件 → 新建 → 项目
   

   

2. 选择 “默认模板”、勾选 “uni-app x”、使用 “Vue 3”，输入项目名，点击创建
   

   

3. 创建完成的项目结构
   

   

4. 在项目根目录添加常见的 .gitignore 配置

   HELP.md
   target/
   .mvn/wrapper/maven-wrapper.jar
   !**/src/main/**/target/
   !**/src/test/**/target/
   
   ### STS ###
   .apt_generated
   .classpath
   .factorypath
   .project
   .settings
   .springBeans
   .sts4-cache
   
   ### IntelliJ IDEA ###
   .idea
   *.iws
   *.iml
   *.ipr
   
   ### NetBeans ###
   /nbproject/private/
   /nbbuild/
   /dist/
   /nbdist/
   /.nb-gradle/
   build/
   !**/src/main/**/build/
   !**/src/test/**/build/
   
   ### VS Code ###
   .vscode/
   

5. 在 .gitignore 中 忽略 uni-app 应用编译后的产物

   /unpackage/
   

[xuxiaowei]

基于 浏览器 运行 uni-app x 项目

1. 选中项目 → 运行 → 运行到浏览器 → Chrome
   

   

2. 控制它显示可使用的端口等信息
   

   

3. 浏览器显示的内容
   

   

[xuxiaowei]

基于 Android App 基座 运行 uni-app x 项目

• 选中项目 → 运行 → 运行到手机或模拟器 → 运行到 Android App 基座
  

  

• 默认 Android 设备列表为空
  

  

基于 Android Studio 模拟器 运行

1. 打开 Android Studio，点击“New Project”
   

   

2. 选择第一个即可
   

   

3. 默认即可
   

   

4. 等待所有进度条完成
   

   

5. 完成项目创建
   

   

6. 添加 Android 模拟器
   

   

7. 根据自身情况选择一个型号
   

   

8. 根据自身情况做调整
   

   

9. 提示下载文件大小
   

   

10. 等待下载完成
    

    

11. 点击 Next 即可完成创建
    

    

12. 创建结果
    

    

13. 直接运行 Android 模拟器
    

    

14. Android 模拟器 运行结果
    

    

15. Android 模拟器 操作按钮
    

    

16. 在 HBuilderX 刷新设备，即可看到上述 Android 模拟器
    

    

17. 选择 Android 设备，点击运行
    

    

18. HBuilderX 内运行结果
    

    

19. Android Studio 模拟器 运行结果
    

    

基于 Android 手机 运行

• 以 华为 手机为例

1. 多次点击“关于手机”中的系统版本号
   

   
   
   
   

2. 提示输入手机密码

3. 正确输入密码后，进入“开发者模式”
   

   

4. 在“系统和更新”中，可以看到“开发人员选项”
   

   

5. “开发人员选项”的内容
   

   

6. 使用数据线连接到电脑，点击“正在通过 USB 充电”
   

   

7. USB 连接方式修改为“MIDI”
   

   

8. Mac 电脑提示“允许配件连接？”，点击“允许”

   

9. 手机打开“USB 调试”，点解确定
   

   

10. 点击确定即可
    

    

11. 在 HBuilderX 刷新设备，即可看到上述 Android 手机

    

12. 手机上安装的 uni-app x 调试基座
    

    

13. APP 内容
    

    

相关文档

• uni-app x 纯原生跨平台 APP Android 安卓 云打包
• Android 安卓 证书：使用命令行 keytool 创建证书