[原创]docker+jenkins+gradle+android sdk+gitee自动打包部署Gitee上的Android项目（超详细）

最新推荐文章于 2024-05-16 01:09:18 发布
最新推荐文章于 2024-05-16 01:09:18 发布
阅读量2.3k 收藏 4
点赞数 2
分类专栏： CI/CD Android 文章标签： docker devops jenkins linux gradle
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_38182842/article/details/110201832
版权

docker+jenkins+gradle自动打包部署Gitee上的Android项目

文章目录

前言

自动化拉取Gitee上Android项目的代码并编译打包（CI/CD）
环境：centos7
JDK：1.8
Gradle：5.1.1
Android SDK：28

一、宿主机环境的安装

说明：
- 所需环境：使用Jenkins自动编译打包Android项目为.apk文件需要依赖的环境有JDK、Gradle、Android SDK，其中SDK的安装最为重要！
- 确定版本：首先要确定自己项目所使用的JDK版本(1.8)，Gradle版本(5.1.1)和SDK(28.0.3)的版本，这一点非常的重要！！！
- 容器卷挂载：通过容器卷挂载的方式（下一节会讲到），让docker中的jenkins使用外部的环境，同时也要在jenkins的系统设置中设置环境变量（Configure System–>Global properties）。

1.JDK

Jenkins自带JDK1.8版本，如果你的项目用的是11或者15，需要自己下载jdk的环境到宿主机，并在/ect/profile里面配置环境变量（以下的1.8只是做个演示）
在这里插入图片描述
并使用容器卷-v的方式让容器内部用到此环境。
But，下面第3步Android SDK环境的配置需要JAVA环境，所以宿主机还是要安装JDK
/(ㄒoㄒ)/~~

2.Gradle

Jenkins的系统是可以选择合适版本的Gradle并安装，无需在宿主机安装Gradle（当然也可以容器外部安装，挂载到内部，不过有点多此一举），具体jenkins关于设置Global Tool Configuration稍后再讲，这里只是放一张图片。
在这里插入图片描述

3.Android SDK！！

这部分的安装是最重要的，需要在宿主机安装SDK环境，之后通过挂载的方式使用SDK环境！
编译安卓项目的前提要在服务器上安装SDK（不是通过Android Studio安装），但是网上查到的版本最新也只到SDK 24（比如这个网站https://www.androiddevtools.cn/就好久没更新了），So我们去官网下载。
Android使用的SDK版本在build.gradle里面查看compileSdkVersion
在这里插入图片描述
因为SDK环境的安装非常重要，所以我单独写了一篇博客。
如何安装最新版本Android的SDK见我的这篇文章👇
https://blog.csdn.net/qq_38182842/article/details/110170630

4.Maven

这里只是顺便提一下Maven，如果是java web项目，需要打jar包或者war包，Maven是必须的，但是也可以通过jenkins关于设置Global Tool Configuration来配置你需要的Maven版本。

二、Docker安装Jenkins

官方安装教程：
https://hub.docker.com/_/jenkins

1.拉取镜像

# 拉取lts(long term support)版本 
docker pull jenkins/jenkins:lts

2.挂载外部环境

我们只需要挂载2个路径
a. 容器内的/usr/local/android-sdk （此路径名字随意，后面会配置android-sdk环境变量会用到这个路径）
b. 容器内的/var/jenkins_home
说明： Gradle和JDK我们使用jenkins提供下载的

# 只需要挂载 android-sdk 和 jenkins_home就行
docker run -d -it --name jenkins -p 8080:8080 -p 50000:50000 -v /opt/android-sdk:/usr/local/android-sdk -v /root/dockerContainerFile/jenkins:/var/jenkins_home  jenkins/jenkins:lts

注意！外部挂载目录/root/dockerContainerFile/jenkins需要修改权限，否则会因为无法写入数据导致容器不能启动

chwon -R 1000:1000 /root/dockerContainerFile/jenkins

在这里插入图片描述
官方是这样说的：
在这里插入图片描述

# 这里顺便提一下外部jdk和maven的挂载方式
docker run -d -it --name jenkins -p 8080:8080 -p 50000:50000 -v ${JAVA_HOME}:/usr/local/jdk -v ${M2_HOME}:/usr/local/maven -v /opt/android-sdk:/usr/local/android-sdk -v /root/dockerContainerFile/jenkins:/var/jenkins_home  jenkins/jenkins:lts

# 其中${JAVA_HOME}值为/opt/jdk1.8.0_271
# ${M2_HOME}值为/opt/apache-maven-3.6.3

三、初始登录Jenkins

说明：通过8080端口访问

1.首次登录Jenkins的相关操作

  • 复制挂载目录下的/secrets/initialAdminPassword中的初始密码在这里插入图片描述
  • 选择左边的默认插件，后期我们要安装插件再另外配置
    在这里插入图片描述
  • 点击开始
    vv
  • 创建初始Admin用户
    在这里插入图片描述
  • 使用默认url连接Jenkins
    在这里插入图片描述
  • 完成
    在这里插入图片描述

四、Jenkins的插件和环境设置

1.Gitee插件和私人令牌

私人令牌是为了保障Jenkins能够成功拉取项目

  • 下载Gitee插件
    Manage Jenkins->Manage Plugins在这里插入图片描述
    搜索Gitee插件并安装
    在这里插入图片描述

  • Gitee官网生成私人令牌
    登录自己的Gitee账号 Settings->Personal access tokens
    在这里插入图片描述
    填写描述并点击commit
    在这里插入图片描述
    保存这串token值，下一步用到这个token
    在这里插入图片描述

  • 在Jenkins的系统设置中配置Gitee
    回到jenkins进入系统设置
    在这里插入图片描述
    配置Gitee连接
    在这里插入图片描述
    点击Add之后第三步进入如下，只要设置Kind和Token就行
    在这里插入图片描述
    最后一定要测试连接成功才行
    在这里插入图片描述
    最后点击Apply 再点Save

  • 本文不涉及Gitee的webhook
    什么是webhook？简单点说就是当你git push之后，jenkins会自动收到消息并构建打包我们的项目，类似"订阅-发布模型"。

2.Gradle环境

  • 进入全局工具设置Global Tool Configuration
    在这里插入图片描述
  • 安装Gradle
    说明：本例让jenkins自动安装，当然可以选择启动容器的时候挂载宿主机的Gradle的目录（Gradle版本要和Android项目用的Gradle一致，我一开始构建失败，后来才发现是Gradle版本不一致的问题）
    在这里插入图片描述

3.JDK环境

  • Jenkins默认使用jdk1.8，无需设置，如果需要用jdk11或者15请看下面
  • 如果在启动容器的时候我们挂载了 -v ${JAVA_HOME}:/usr/local/jdk
# 这里顺便提一下外部jdk和maven的挂载方式
docker run -d -it --name jenkins -p 8080:8080 -p 50000:50000 -v ${JAVA_HOME}:/usr/local/jdk -v ${M2_HOME}:/usr/local/maven -v /opt/android-sdk:/usr/local/android-sdk -v /root/dockerContainerFile/jenkins:/var/jenkins_home  jenkins/jenkins:lts
# 其中${JAVA_HOME}值为/opt/jdk1.8.0_271
# ${M2_HOME}值为/opt/apache-maven-3.6.3
  • 那么我们在下面的JAVA_HOME就填写容器内路径/usr/local/jdk
    在这里插入图片描述

4.Android SDK环境

  • 来到系统设置
    在这里插入图片描述

  • 设置环境变量ANDROID_SDK_ROOT
    它的值与之前挂载的路径一致-v /opt/android-sdk:/usr/local/android-sdk

# 只需要挂载 android-sdk 和 jenkins_home就行
docker run -d -it --name jenkins -p 8080:8080 -p 50000:50000 -v /opt/android-sdk:/usr/local/android-sdk -v /root/dockerContainerFile/jenkins:/var/jenkins_home  jenkins/jenkins:lts

在这里插入图片描述

  • SDK环境OK了

五、Jenkins构建新的项目

1.新建一个自由风格的项目

在这里插入图片描述

2.General 设置

  • Gitee Connection选择之前设置Gitee时取的那个名字
    在这里插入图片描述

说明：以下参数也可以暂时不设置，后期有需要再加（我们只要先让项目成功构建起来）。
常见的参数我找不到了，后期在下面补上

  • 添加第一个Choice Parameter：IS_JENKINS，用来在gradle构建时替换gradle.properties里定义的参数，这样可以在gradle脚本里用该参数区分当前是不是jenkins构建；
    在这里插入图片描述
  • 添加第二个Choice Parameter：BUILD_TYPE，这个参数用来配置执行不同构建类型(是执行debug还是release构建)；
    在这里插入图片描述
  • 添加一个Git Parameter：GIT_TAG用来选择拉取git代码的分支，会自动识别git仓库的所有分支供构建的时候选择（需要安装git parameter插件）
    在这里插入图片描述

3.Source Code Management 源码设置

  • Repository URL填源码仓库的地址，下面的Branches to build 默认拉取master分支（如果安装了Git Parameter插件，在构建的时候可以手动选择分支）
    在这里插入图片描述

  • 点击Add，填Gitee的账户和密码
    在这里插入图片描述

4.Build Trigger 触发器设置

说明：以下是关于Webhook的配置，我们的Jenkins在本地服务器，要是Gitee通知本地的Jenkins构建还需要配置网络啥的，所以我只简单写了一下。

  • 当git push的时候构建项目
    在这里插入图片描述
  • 生成 Gitee webhook 52c09bxxxxxxxxxxxxxxxxxxa9046265
    在这里插入图片描述
  • 去Gitee.com配置webhook

5.Build 构建设置

# /bin/bash
# 我将app-release.apk换了个名字叫${BUILD_TAG}.apk，并输出目录下的内容
# BUILD_TAG："jenkins-${JOB_NAME}-${BUILD_NUMBER}"
# 最后执行引号中的lftp命令，将文件传到指定FTP服务器
mv app/build/outputs/apk/release/app-release.apk app/build/outputs/apk/release/${BUILD_TAG}.apk 
ls app/build/outputs/apk/release
lftp -c "open -u app,app 10.1.0.19:2121; ls /app; put app/build/outputs/apk/release/${BUILD_TAG}.apk"

Shell执行的注意点：

a. 上面的步骤是由上到下执行的，添加Execute shell这一步必须在gradle脚本之后
b. app/build/outputs/apk/release/这个是容器内路径，全称如下，但是我们只要填项目名称（我的是gm_app）之后的路径就行
在这里插入图片描述
c. shell脚本的执行是在容器内部执行的，容器内可能没有lftp命令，我们需要以root身份进入容器内部，更新apt-get命令，并安装lftp命令。

# 以root身份进入容器
docker exec --privileged -u root -it jenkins /bin/bash
# 更新apt-get指令
apt-get update
# 安装lftp命令
apt-get install lftp

在这里插入图片描述

  • OK, Build这个关键步骤搞定

6.Post-build Actions 构建后行为设置

  • 注意: 对打包好的apk的操作（比如执行shell脚本，传输我们的apk到指定服务器），这些操作的设置不在这一步，应该在上一步Build中添加执行shell脚本。
  • 添加Archive the artifacts（为了打包成功后在workspace显示apk文件）
  • 这个路径的作用是去搜集app/build/outputs/apk/目录下的文件，并显示出来。注意这个路径是在workspace/构项目的名字/ ，下面的/app/build/outputs/apk去找文件，我们打包好的东西就在apk这个目录下
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述

7.进行构建测试

  • 点击build
    在这里插入图片描述

  • 可以在Console Output看到构建的细节
    在这里插入图片描述

  • 耐心等待构建成功，Last Successful Artifacts里显示的就是我们构建好的项目（Post-build Actions里面没有添加Archive the artifacts的话，这边是不会显示.apk文件的 ）
    在这里插入图片描述

8.大功告成

我们也可以将构建好的.apk文件通过ftp发送到指定的服务器，也可以生成二维码给测试人员提供下载。
在Build中，在Gradle下方（只可以在下方）添加Execute shell，增加需要执行的shell脚本。具体介绍看5.Build->Execute shell 设置。
在这里插入图片描述

总结

第一次用Jenkins构建项目，也走了不少坑，大大小小尝试了24次：

  • gradle版本的不一致；
  • SDK环境配不对；
  • 文件没给写权限导致构建的时候不能写入；
  • 挂载了jdk11但其实项目用的jdk是1.8（用jenkins默认的就行）；
  • 找不到打包之后的.apk的路径（使用Archive the artifacts在workspace显示打包好的文件）

以上步骤都已经过亲自验证，不会有什么问题。其中我觉得Android SDK环境的配置挺重要的。
才疏学浅，更高级的Jenkins配置还在学习中，请大家多多指教~

参考文档

https://blog.csdn.net/wangxudongx/article/details/108173608
https://blog.csdn.net/weixin_38062353/article/details/82357085
https://blog.csdn.net/wc1695040842/article/details/102230401

攻城狮YoungDawn
关注
  • 2
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 5
    评论
专栏目录
Jenkins+docker+gitee自动化部署
ds111ffff的博客
06-09 496
Jenkins一键自动化部署+脚本编写
Docker环境搭建安卓打包环境
qq_46133033的博客
03-01 605
docker构建安卓打包环境主要步骤。
一键搞定centos7的docker+selenium+appium+jenkins+android_app打包成apk环境搭建
nhb687095的博客
11-09 161
启动项目的start_all.sh，一键构建环境安装完包含的环境docker-ce最新版本selenium运行环境chrome无头运行chromedriver是84appium运行环境appium 1.18版本包含appium-dockersdk运行环境adb 1.0.41sdk build有29.0.3和28.0.3 - sdk编译环境是28 29jenkins运行环境集成大量插件。
jenkins+docker-compose+gitee实现自动化部署nestjs项目_docker打包nestjs
最新发布
2401_84563987的博客
05-16 441
下方这份完整的软件测试视频教程已经整理上传完成，需要的朋友们可以自行领取**
Android Studio 打包APK文件（Debug版和Release版）
LLL778888的博客
12-01 1万+
现在Android手机上所有应用都是apk,分为系统自带和第三方应用提示：以下是本篇文章正文内容，下面案例可供参考对文章进行总结：本文仅仅简单介绍了Android如何生成可安装的APK文件。
Docker环境下Jenkins结合Gitee搭建流程总结
qq_42394166的博客
12-07 1928
jenkins实现了项目CI/CD，更好的体现了持续交付，解决了在手动打包部署项目的繁杂
手把手教你配置android持续集成开发环境1
08-08
2. **基本工具配置**：定义Jenkins需要使用的工具，例如Git、Gradle和Android SDK，确保它们的路径正确。 3. **插件管理**：Jenkins拥有丰富的插件生态系统，可以安装与Android相关的插件，如Android Emulator ...
android_prueba_jenkins
05-12
在IT行业中，自动化构建与测试是提高效率的关键步骤，而Jenkins作为一款流行的持续集成工具，被广泛应用于Android项目的开发流程中。本篇将深入探讨如何利用Jenkins进行Android应用程序的自动化测试。 首先，我们要...
connectbot：ConnectBot是Android的第一个SSH客户端
02-03
连接机器人 ConnectBot是Android的客户端，可让您通过加密的安全链接连接到远程服务器。 Google Play 编译中 Android Studio ConnectBot是最容易在开发的。... 要在本地运行Jenkins CI管道，您可以通过Docker安装来使
Jenkins Plugins
07-19
在 Jenkins 中，插件扮演着至关重要的角色，从自动化构建、测试、部署到提供丰富的报告和集成第三方工具，几乎每一个功能都可以通过相应的插件实现。以下将详细讨论 Jenkins 插件的关键知识点： 1. **插件市场与...
基于Java的车辆故障维修管理系统源码数据库.zip
02-16
可能使用Git进行版本控制，Maven或Gradle进行构建，Junit进行单元测试，Docker进行容器化部署，以及Jenkins进行持续集成和交付。 8. **安全与性能优化**: 为保障系统安全，开发者可能采用了如HTTPS加密通信、JWT...
Docker+Jenkins+Gitee自动化部署maven项目，加入Nexus镜像仓库（补充篇）
StoNENee的博客
06-03 1244
Docker+Jenkins++Nexus+Gitee自动化部署maven项目
实战：Docker+Jenkins+Gitee构建CICD流水线
勤于笔记，成于点滴。
07-26 1860
实战：Docker+Jenkins+Gitee构建CICD流水线还是较为简单，本次我们引入了Docker Pipleline进行我们项目从gitee直接流水线话构建部署。当然我们也可以按照Generic Webhook Trigger插件进行自动触发构建，也是比较简单。
Aliyun配置Android SDK环境
码农的记录
01-24 1489
最近在阿里云上配置Android SDK的环境，发现最新的Android SDK命令已经改变了很多，这边就记录下这次的操作吧。 首先是下载Android SDK，找到官网，获取最新的SDK的地址。 最新的2018-01-22的版本地址为： https://dl.google.com/android/repository/sdk-tools-linux-3859397.zip 这里我以配置J
tar (child): .tgz\r：无法 open: 没有那个文件或目录
易的博客
10-29 2654
Linux下运行bash脚本显示“: /usr/bin/env: "bash\r": 没有那个文件或目录 程序员小熊2017-12-18 14:45:4518395收藏7 分类专栏：Linux 版权 用 ./ 运行bash脚本文件出现 报错信息 /usr/bin/env: "bash\r": 没有那个文件或目录 错误原因：这主要是因为bash后面多了\r这个字符的原因。在linux终端下，输出\r会什么都不显示，只是把光标移到行首。于是终端虽然输出了/usr/bin/env ba...
使用Docker编译Android系统源码
热门推荐
godiors_163的博客
03-01 1万+
使用Docker编译Android系统源码引言：最近公司业务转型，开始倒腾起安卓系统，做了几个月的安卓APP开发，最近又需要做系统定制，所以撸起袖子搞起… 首先干嘛？部署开发环境，开发环境一直是让人头疼的问题，何况我们不只需要一套环境，这样整来整去很容易就把系统玩废了，一旦出了问题就等着崩溃吧。所以借着这几年火起来的docker布置一个我们的开发环境。 其实环境配置大同小异，我们只是需要把编译环
记一次Docker演示环境镜像打包过程
zzz3112362088的博客
06-10 8251
公司经常给客户搭建Demo演示或测试环境，之前的部署工作流程太过繁琐且非常耗时，于是有了下面这篇文章的内容。这里说一下Demo中包含的服务组件MySQL5.7 + Redis5.0 + Tomcat9（2个tomcat服务） + tcp消息转发模块（以netty框架为基础开发的一个tcp消息转发模块）。 那么要使得一个镜像中包含这么些个服务，我的想法是以centos7为镜像基础docker镜像，...
怎么将vue的移动端项目打包成手机的app软件apk格式的。hbuilderx 云打包。
qq_54753561的博客
08-28 2180
怎么将vue的移动端项目打包成手机的app软件apk格式的。hbuilderx 云打包。打包app严选商城软件，里面有加入购物车，登陆，添加地址，三级联动。是用vue3+vant写的。写的博客不复杂跟着做一下总能学到。写给我亲爱的粉丝谢谢支持..................
jenkins 动态部署gitee+docker
qq_44723556的博客
08-16 322
注意jenkens我是用了挂载，即jenkins构建后的文件都在下面，target文件夹中含有jar包，将 dokcerfile通过ssh推送到target文件夹中，执行以上代码完成docker 镜像创建。1、首先安装maven插件，并在系统管理-》全局工具配置 中配置maven，勾选自动安装。## 指定容器目录挂载到 /var/lib/docker/volumes/随机名。2、安装gitee插件，在插件管理中下载即可 以下是已下载好的。在gitee中配置webhooks。配置gitee，选择代码分支。
Docker + Jenkins + Gitlab+Harbor 自动化构建部署的详细资料
05-24
以下是 Docker + Jenkins + Gitlab+Harbor 自动化构建部署的详细资料： 1. Docker Docker 是一种容器化技术，可以将应用程序及其依赖项打包为一个可移植的容器，从而实现快速、一致和可靠的部署。 2. Jenkins Jenkins 是一种开源的自动化服务器，可以用于自动化构建、测试和部署软件。 3. Gitlab Gitlab 是一种基于 Git 的代码托管平台，可以管理源代码、问题和合并请求等。 4. Harbor Harbor 是一种开源的 Docker 镜像仓库，可以存储和管理 Docker 镜像。 下面是 Docker + Jenkins + Gitlab+Harbor 自动化构建部署的步骤： 1. 创建一个 Gitlab 仓库，用于存储应用程序代码。 2. 在 Jenkins 中创建一个新项目，并配置 Gitlab 的 Webhook，以便在代码推送到 Gitlab 时触发构建。 3. 在 Jenkins 中配置 Docker 插件，以便在构建完成后自动构建 Docker 镜像。 4. 在 Jenkins 中配置 Harbor 插件，以便在构建完成后自动将 Docker 镜像上传到 Harbor 镜像仓库。 5. 在 Jenkins 中配置部署脚本，以便在 Docker 镜像上传到 Harbor 后自动部署到目标服务器。 6. 在 Gitlab 中配置 CI/CD 流水线，以便在代码推送到 Gitlab 后自动触发 Jenkins 构建和部署流程。 7. 测试自动化构建部署流程，确保能够自动构建、上传和部署 Docker 镜像。 总之，Docker + Jenkins + Gitlab+Harbor 自动化构建部署可以大大提高软件开发和部署的效率，可以快速构建、测试和部署应用程序，从而实现持续集成和持续交付。
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值