本操作流程是为没有跑通过打包流程的朋友提供一个示例,老手请绕行。
一、Hbuilderx 设置与操作
开发完成uni-app项目后,在manifest.json文件中配置应用标识(AppId),该AppId需从hbuilderx平台获取。接着设置Android应用图标。最后,通过Hbuilderx将相关资源文件打包到本地。
二、中间衔接工作
下载Android离线SDK(正式版),解压后记下SDK地址。然后将打包好的uni-app资源文件从项目目录下的unpackage/resources转移到Android SDK目录下的HBuilder-Integrate-AS/simpleDemo/src/main/assets/apps中。
三、安装Android Studio及项目发布配置
建议下载稳定的历史版本Android Studio,可从历史版本下载地址获取。官方最新版也可从谷歌开发者网站下载。在Android Studio中新建"Empty Activity"类型项目,并使用该项目打开Android SDK中的simpleDemo目录。修改assets/data/dcloud_control.xml文件中的AppId配置项,改为从hbuilderx平台获取的AppId。同时,拷贝Gradle Scripts/build.gradle(Module:simpleDemo)文件中defaultConfig配置节中的applicationId。
四、安装Java环境
如果Android Studio已安装,检查JDK的安装位置,并将JDK的环境变量添加到系统环境变量Path中,以便在任意目录使用命令行工具。在系统变量中新建JAVA_HOME变量,值为JDK安装路径,并在Path变量中添加JDK的bin目录路径。之后,通过Win+R打开命令行,输入keytool --help验证keytool是否可用,若无错误提示则说明配置成功。
五、生成密钥和证书文件
在命令行中切换到指定目录,输入以下命令生成密钥对:
keytool -genkeypair -v -keystore mykey.jks -keyalg RSA -keysize 2048 -validity 10000 -alias mykey -storepass aa123789
参数说明:-keystore指定Keystore文件名,-keyalg指定密钥算法为RSA,-keysize指定密钥长度,-validity指定证书有效期,-alias指定密钥别名。可修改高亮部分内容,但每次生成后需在后续步骤中相应修改。生成后,使用命令keytool -list -v -keystore test.jks查看证书信息。注意,最新版JDK已废弃MD5签名算法,仅支持SHA1和SHA256。
六、Hbuilderx开发者中心相关配置
登录Hbuilderx开发者中心的应用列表,找到对应AppId的应用,点击进入配置页面。在命令行中使用keytool -list -v -keystore mykey.jks查看JKS文件信息,记录SHA1和SHA256值,填入配置页面的相应内容框(MD5可忽略)。提交后获取AppKey。
七、Android Studio中修改App Key
回到Android Studio,将获取的AppKey替换manifests文件夹下AndroidManifest.xml文件中meta-data配置节的android-value内容。
八、Android Studio打包前配置证书文件及密钥
打开Android Studio的配置界面,填写证书文件路径、密钥别名、存储密码和密钥密码,提交保存。
九、执行打包操作
在Android Studio中执行打包操作,生成APK文件。生成地址通常为simpleDemo/build/outputs/apk/debug目录,该APK文件可直接发送到安卓手机安装体验。
补充FAQ:
- 若安装后桌面上找不到应用,一般是因为manifest.json中未设置图标,需返回Hbuilderx开发环境设置图标。
- 若keytool生成JKS文件后查看时报错,可尝试更换旧版本keytool,如使用稳定的历史版本JDK。
如有纰漏,敬请批评指正!