适用对于终端编译环境不熟悉的人看,仅mac端
hippy 调试文档官网地址
前提:请使用node16
联调预览效果图:
编译iOS Demo环境准备
未跑通,待补充
编译Android Demo环境准备
1、正常安装Android Studio
2、下载Android NDK,安装可能会遇到点击没有反应的问题
参考这位大佬的安装:Mac安装NDK android-ndk-r25b-darwin.dmg
3、Android Studio打开项目examples/android-demo,执行项目构建
安装虚拟机器:右侧 - Device Manager,手机连机的虚拟机通过adb的方式会因为未加密链接失败;
3.1 报错sdk没有安装
安装sdk-参考文档
也可以直接执行:brew install android-sdk
安装后需手动添加环境变量,通常会默认安装在:/Users/用户名/Library/Android/sdk (mac系统中)
重启项目
3.2 报错cmake未找到,但可能已经在安装ios环境的时候安装过,命令行可以查到版本,并也试过添加过local.properties地址
cmake应在sdk下按照提示安装对应版本即可,cmake没安装过时左侧会有一个下载的图标,点击下载即可
重启项目
3.3 报错Task ‘wrapper’ not found in project ‘:example’.
FAILURE: Build failed with an exception.* What went wrong:
Task 'wrapper' not found in project ':example'.* Try:
> Run gradle tasks to get a list of available tasks.
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.* Get more help at https://help.gradle.orgBUILD FAILED in 245ms
项目代码里没有wrapper相关信息,需要新建,可以新建一个项目粘贴gradle文件夹过来。
在Android Studio中,wrapper是指一个用于管理项目中Gradle构建工具版本的工具。它包括Gradle Wrapper脚本文件和相关的Gradle发行版。使用wrapper可以确保团队成员无需手动安装特定版本的Gradle,而是通过项目中的wrapper自动获取所需的Gradle版本。
Gradle是一种基于Apache Ant和Apache Maven概念的构建自动化工具。它允许开发者定义项目的结构,并使用基于Groovy或Kotlin的领域特定语言来配置项目的构建过程。Gradle广泛用于构建Java、Kotlin和Android应用程序等项目。 它提供了一种灵活且可定制的方式来管理项目的依赖关系、构建过程和部署流程。如果项目中缺少Gradle,构建可能会失败,因为Gradle负责处理项目的依赖关系、编译代码、运行测试和打包应用程序等任务。因此,如果项目依赖于Gradle来构建,没有Gradle将导致项目无法完成构建过程。
重新执行“RUN”
3.4报错:Task ‘prepareKotlinBuildScriptModel’ not found in project ‘:example’.
添加:
task prepareKotlinBuildScriptModel {}
到build.gradle.kts中(仅是个声明,任意位置即可)
3.5 调试页面输入调试地址,Android模拟器访问127.0.0.1(localhost)被拒绝
10.0.2.2是Android模拟器设置的特定ip,是本机电脑的alias。换了之后会出现,点击调试页面是空白,模拟机器上也是空白
不符合预期可以出现组件的调试页面:
我跑的代码是vue-next,模拟器预览的是react;
怀疑前端项目在运行跟vue-next,react本身应该是没跑起来,不匹配导致的预览时index.bundle,关掉前端项目重启并重新运行android staudio就可以了。
3.6、连接真机
Android 使用了 adb 的端口映射功能,解决了真机到开发机的通讯问题。由于 ARM 模拟器运行效率问题,更加推荐使用真机进行调试。
安装adb
安装adb之后adb dervices
检测不到手机,先检查下是否打开了开发者模式,不只是USB-传输文件
手动打开开发者模式(华为手机)
检测到设备之后,debug会出现device connected的提示,有时候会意外断开,尝试重连通常可以解决
补充信息
安卓的常见结构目录:
Android studio默认打包路径是android/app/release和android/app/debug两个文件夹