# 自动打包环境部署文档
## 一、应用的技术栈
Gitlab +Jenkins + Gradle + pgyer
## 二、环境部署
### 1. 安装java环境，配置环境变量
确认项目对应的java版本
下载安装参照网上文档，军职为例：
[root@localhost ~]# java -version
java version "1.8.0_261"
### 2. 安装gradle环境，配置环境变量
军职gradle 是6.8.1
Gradle是基于Ant和Maven的构建工具，同样需要Java运行环境，安装之前需要先安装配置好Java环境，可以参考之前的博客：[Linux下安装JDK](http://www.cnblogs.com/imyalost/p/8709578.html)
Gradle官方下载地址：https://gradle.org/releases/
#### 2.1 下载 gradle-6.8.1-all.zip文件到服务器上
#### 2.2 解压文件
```shell
# 将文件解压到指定目录
unzip -d /opt/gradle gradle-6.8.1-all.zip
```
#### 2.3 配置环境变量
```shell
vim /etc/profile
# 在配置文件中增加环境变量配置
export PATH=$PATH:/opt/gradle/gradle-6.8.1/bin
# 生效配置文件
source /etc/profile
#查看版本，验证是否安装正确
gradle --version
```
### 3. 安装jenkins环境
#### 3.1 下载jenkins
```shell
下载jenkins地址：
https://www.jenkins.io/download/
http://mirrors.jenkins.io/war-stable/
linux下载命令直接下载war包：
wget http://mirrors.jenkins.io/war-stable/latest/jenkins.war
```
#### 3.2 下载tomcat
```shell
tomcat 下载地址https://tomcat.apache.org/
# 下载tomcat，并解压到指定目录(高版本的tomcat，要求更高版本的java版本，会报404，因为需要使用当前版本的java，所以tomcat不要用太新的版本，测试apache-tomcat-9.0.38.tar.gz 可以)
tar -zxvf apache-tomcat-9.0.38.tar.gz -C /opt/
# 将jenkins.war报 移动或复制到webapps目录下
cp jenkins.war /opt/apache-tomcat-9.0.38/webapps/
#启动tomcat服务器
sh /opt/apache-tomcat-9.0.38/bin/startup.sh
# 登录jenkins
http://192.168.9.122:8080/jenkins
```
#### 3.3 jenkins配置
```shell
# 初始密码位置
/root/.jenkins/secrets/initialAdminPassword
# 代理配置，服务器连接外网无需配置代理，如未连网配置代理服务器 保存继续代理可用会自动开始下载插件
```
### 4. 安装android sdk
```shell
安装 SDK Tools 路径： https://www.androiddevtools.cn/
# 安装安卓SDK Tools
wget https://dl.google.com/android/android-sdk_r24.4.1-linux.tgz
# 解压到指定位置
tar -zxvf android-sdk_r24.4.1-linux.tgz -C /opt/
#配置环境变量
vim /etc/profile
export PATH=$PATH:/opt/android-sdk-linux/platforms
export PATH=$PATH:/opt/android-sdk-linux/tools
export ANDROID_SDK_ROOT=/opt/android-sdk-linux
# 生效配置文件
source /etc/profile
# 展示可下载的sdk列表
android list sdk --all
# 安装对应的编号（开发确认对应版本）
android update sdk -u --all --filter 2,3,4,51,53
# 安装完成
jenkins工作目录下，项目目录下执行构建命令即可
gradle assembleDebug
```
## 二、环境配置
### 1.配置jenkins
```shell
# 新增插件
Upload to pgyer (上传蒲公英用)
GitLab Plugin （做gitlab webhooks用）
如果需要企业微信或钉钉通知下载对应插件或者在构建后操作中调用对应api即可
# 安装完成后 构建触发器中增加了如下现象，这个url 在git中用：
Build when a change is pushed to GitLab. GitLab webhook URL: http://192.168.9.122:8080/jenkins/project/app_test
蒲公英插件参照
https://www.pgyer.com/doc/view/jenkins_plugin
api结合
https://www.pgyer.com/doc/view/api
```
### 2. 配置gitlab
```shell
# git 配置ssh key认证
#这个是覆盖更新方式
860 git config --global --replace-all user.name "lixuejun"
861 git config --global --replace-all user.email "lixuejun@xuetangx.com"
868 ssh-keygen -t rsa -C "lixuejun@xuetangx.com"
870 cat .ssh/id_rsa.pub # 公钥 粘贴到gitlab 上
871 cat .ssh/id_rsa # 私钥 在jenkins上创建认证
```
添加webhook
## 三、中途报错
```shell
FAILURE: Build failed with an exception.
* What went wrong:
A problem occurred configuring project ':a_mooc_app'.
> SDK location not found. Define location with an ANDROID_SDK_ROOT environment variable or by setting the sdk.dir path in your project's local properties file at '/root/.jenkins/workspace/app_test/local.properties'.
* Try:
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.org
这个构建写死的目录：
在配置文件中增加一个环境变量即可，指定sdk的目录
export ANDROID_SDK_ROOT=/usr/android-sdk-linux
```
```shell
```
