持续集成-UniApp

青春须早为,岂能长少年。这篇文章主要讲述持续集成-UniApp相关的知识,希望能为你提供帮助。

一个基础的APP构建脚本,大佬请无视本文。作者才疏学浅,只能重复尝试总结经验。
FROM 假的前端工程师
背景UniApp官方开发工具HBXHbuilderX简称)本地打包需要手动导出工程文件然后对于android项目一顿操作。
回想起之前测试追着我这个开发一直要安装包的场景(之前利用Jenkinsios平台项目进行持续集成,但是远不能到达提交代码就可以自动打包生成一个APP的地步)
实现的效果
  1. 提交代码即可打包(自动流水线操作)
  2. 支持在gitlab-ci.yml配置打包的证书
  3. 支持定义包名
  4. 支持自定义APP名称
流程阶段按照传统的思路,即:
  1. HbuilderX生成APP资源文件
  2. 按照模版生成原生工程替换文件
  3. 生成文件替换原生工程文件
  4. Android Studio打包
其他思路是借助fastlane之类的自动化打包工具
部署示例图
持续集成-UniApp

文章图片

【持续集成-UniApp】NPM 缓存可选
gitlab-ci.yml文件展示
stages: - build_uniapp_file - rewrite_android_file - replace_android_file - build_appvariables: BUILD_TYPE: app-plus # 目前该流程仅可打包APP PackageName: com.harrycode.testbuild23232 # APP包名 APPID: __UNI__APPID #UNI_APPID APPNAME: 测试 # 软件显示的名字 CerPwd: 123456 # 用于打包的证书密码 CerAlias: app# 打包证书的别名 CerAliasPwd: 123456# 打包哦证书别名的密码 CerPath: ../../../cer/app.keystore # 打包证书的位置,不建议修改,改位置为提交项目的根目录的cer文件夹cache: key: ${CI_COMMIT_SHA} paths: - build-dist/# UNIAPP app-plus 生成文件 - android-files/# 生成的Android文件(部分) - android-temp/HBuilder-Hello/ # Android工程文件(可下载后手动操作)Build source files: image: 192.168.1.178:5555/uni-node:v3 # 该镜像是node+vue cli+ UniApp项目模板工程精简文件(详见DockerHub) stage: build_uniapp_file script: - opath=$(pwd) - cp -rf . /buildwork/src - cd /buildwork - rm src/package.json - mv src/build.package.json package.json # - set SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/ & & npm install node-sass# 由于为了加速打包过程,镜像安装了node-sass - npm update & & npm install & & npm run build:$BUILD_TYPE - mkdir $opath/build-dist/ -p - cp -r /buildwork/dist/build/app-plus/* $opath/build-dist/ artifacts: paths: - build-dist/change files as wish: image: name: 192.168.1.178:5555/uniappbuildhelper:latest # 该镜像为Android文件生成工具镜详见DockerHbu(需要配置更多参数需要修改这个文件后,在下一步复制到对应的位置) stage: rewrite_android_file script: - opath=$(pwd) - cd /app - dotnet UniAppBuildHelper.dll - \\cp -r /app/dist/. $opath/android-files artifacts: paths: - android-files/# 本阶段产物,自定义的部分配置文件change file in Android Project: image: busybox stage: replace_android_file # 本阶段使用自定义生成的文件替换进入Android工程 script: - opath=$(pwd) - source_file_path=$opath/android-files - uni_source=$(pwd)/build-dist - mkdir android-temp & & cd android-temp - wget http://192.168.1.178:9090/HBuilder-Hello.zip - unzip HBuilder-Hello.zip - project_src=https://www.songbingjia.com/android/$(pwd)/HBuilder-Hello - //cp $source_file_path/AndroidManifest.xml $project_src/app/src/main - rm -rf $project_src/app/src/main/java/io # 替换包名为文件 - java_dir_path=$(echo"$PackageName"| sed "s/\\./\\//g") - mkdir $project_src/app/src/main/java/$java_dir_path -p # WXEntryActivity.java - \\cp $source_file_path/WXEntryActivity.java $project_src/app/src/main/java/$java_dir_path # WXPayEntryActivity.java - \\cp $source_file_path/WXPayEntryActivity.java $project_src/app/src/main/java/$java_dir_path # dcloud_control.xml - \\cp $source_file_path/dcloud_control.xml $project_src/app/src/main/assets/data # build.gradle - \\cp $source_file_path/build.gradle $project_src/app # strings.xml - \\cp $source_file_path/strings.xml $project_src/app/src/main/res/values # uniapp files - rm -rf $project_src/app/src/main/assets/apps/* - mkdir$project_src/app/src/main/assets/apps/$APPID/www -p - \\cp -r $uni_source/. $project_src/app/src/main/assets/apps/$APPID/www artifacts: paths: - android-temp/HBuilder-Hello/ # 本阶段产物为替换文件后的Android工程文件build_app: stage: build_app image: 192.168.1.178:5555/android-build-box:1.15.0 before_script: # 预操作安装gradle,请放置与内网的nginx静态服务器加速下载 - wget http://192.168.1.178:9090/gradle-5.4.1-bin.zip - mkdir /opt/gradle -p - unzip -d /opt/gradle gradle-5.4.1-bin.zip - export PATH=/opt/gradle/gradle-5.4.1/bin:$PATH script: # 进行打包 - mkdir android-temp/HBuilder-Hello/app/build/outputs/apk/ -p - opath=$(pwd) - cd android-temp/HBuilder-Hello/ - gradle wrapper - bash ./gradlew assembleRelease - \\cp -r $opath/android-temp/HBuilder-Hello/app/build/outputs/apk/. $opath/outputs - rm -rf android-temp/ artifacts: paths: - outputs/ # 本阶段的产物为Release文件夹及其下的APP安装包

效果
持续集成-UniApp

文章图片

持续集成-UniApp

文章图片

提交目录结构
持续集成-UniApp

文章图片

注意:build.package.jsonNPM版本生成的package.json,如需使用NPM,新需要的模块构建时请同步添加dependenciesdevDependencies下的依赖。本目录下的cer文件夹为打包UniApp的证书(证书路径与定义的变量CerPath有关,文中的路径为提交文件的本目录下的cer)。
参考命令
#创建容器 docker run -d --name gitlab-runner-12.10.1 --restart always -v ~/gitlab-runner/config/:/etc/gitlab-runner/-v /var/run/docker.sock:/var/run/docker.sockgitlab/gitlab-runner:latest#进入容器后执行注册Runner sudo gitlab-runner register -n--url=GitLb地址 --registration-token=GitlabRunnerToken自行获取 --executor=docker --description="HP-Mini-PC" --docker-image="docker:19.03.8" --docker-volumes /var/run/docker.sock:/var/run/docker.sock--locked=false

其他事项
  1. 本文使用的镜像将尽快加入DockerHub
  2. 本文的Gitlab-Runner均运行于Docker环境,Gitlab也运行在Docker上。
  3. 本文Gitlab-Runner容器通过官方文档中的挂载/var/run/docker.sock的方式实现。
  4. 本文已经经过构建验证,撰写本文期间构建次数为182次。
  5. 简易Android文件生成器源码 https://gitee.com/harry7988/uniappbuildhelper

    推荐阅读