IONIC3 打包安卓apk详细过程（大量图文）

经历三天的踩坑，跳坑，相信绝大多数的问题都已经覆盖到了，请仔细按照流程来对照操做及检查。

1.基本依赖环境

1. nodejs环境 (做为一个前端相信你已经有了) 
    
   最好提早配置好node的环境变量，便于全局访问。
2. jdk(下面细说) 
   
3. SDK(下面细说，其实主要难就难在SDK配置了) 
   
4. gradle(下面细说) 
   

2. 基本工具

1. gitbash(就是用来替代windows自带的丑陋的CMD) 
   下载：我都打包了！ 
   连接：https://pan.baidu.com/s/1mje7ZHu 密码：ob6m
2. windows自带的CMD(window+R输入CMD，管理员身份运行)
3. VSCode(微软爸爸开发的前端IDE) 
   下载：请自行去微软爸爸官网下载。

3.环境配置

3.1 nodejs (须要配置环境变量)

前端必会，跳过。

不会的去这里看傻瓜教程：https://www.jianshu.com/p/03a76b2e7e00

3.2 jdk (无需配置环境变量)

下载：已经上传网盘↓

连接：https://pan.baidu.com/s/1mje7ZHu 密码：ob6m

请自行根据系统安装32/64位的版本。

安装方法：下载完成，解压，直接按照提示安装，全局点肯定，不出意外，最后的安装路径为：C:\Program Files\Java

OK，jdk安装完成，在cmd中，输入$ java -version验证是否安装成功。

OK。

3.3 sdk (须要配置环境变量)

下载：跟上面的同样，我都打包了。

连接：https://pan.baidu.com/s/1mje7ZHu 密码：ob6m

解压后（直接右键X解压并重命名。由于面还有个文件夹，不建议用右键+E解压）。

将重命名的文件夹，跟jdk放在一个父目录，便于查找：C:\Program Files\SDK

接着配置环境变量，个人电脑——右键属性——-高级系统设置——-环境变量。

在下面的系统变量(s)中，新建，键值对以下：

name: ANDROID_HOME

key: C:\Program Files\SDK

如图所示：

而后在path中，全局声明一下，将;%PATH%;%GRADLE_HOME%\bin缀在最后面，前面有【;】分隔符。

而后运行CMD，输入$ android -h，若是出现一大堆指令，说明你的SDK安装无误，而且环境变量配置OK。

如今，打开SDK目录下的SDK Manager.exe

打开界面上的Tools,选择options，先配置国内镜像：

域名千万不要输入http或者https协议前缀，谁输谁哭。

下面记得勾选。

回到主界面，点packages再点reload

先勾选以下图的三个Tools:

分别是[ Android SDK Tools,Android SDK platform-tools,Android SDK Build-tools]

别急，还没完，下面还有一个：

[SDK platform]

所有选中后，点右下角 install packages 来安装，耐心等待便可。

3.4 gradle安装(须要配置环境变量)

打开：http://services.gradle.org/distributions/

下载：gradle-4.1-bin.zip

一样安装在JDK,SDK的目录下，便于查找。

一样的配置环境变量：

GRADLE_HOME=C:\Program Files\SDK\gradle-4.1

;%GRADLE_HOME%\bin

测试命令（查看版本）：gradle -v

3.基本流程

1.安装ionic和cordova

打开Gitbash,全局安装ionic和cordova（IONIC是UI，cordova负责打包成apk,而且能够调用原生安卓的各类API）

$ cnpm install -g ionic cordova

2.建立ionic项目

桌面右键，在此处gitbash

$ ionic start app tabs

耐心等待完成，在 cd 到 app 子目录(app是你的真实项目目录)，而后

$ ionic serve

稍等片刻，浏览器自动弹出预览界面(建议电脑安装Chrome浏览器)，而且支持持续热更新(Webpack的功能)，以下图所示：

若是作到这一步没问题，说明：

1.nodejs与gitbash没有问题。

2.ionic和cordova没有问题。

4.打包

确保SDK,JDK没问题之后，使用指令

$ ionic cordova build android --release

(若是这条命令有问题，能够去掉–release而后debug编译，编译完成Dos会显示apk目录位置)

如若你聪慧的双眼发现以下字眼：Build Success! 说明你已经成功打包了。耐心等待，命令行结束会提示你apk的生成位置。

OK，此时你已经有了debug的包，可是这个包没有签名，不能发布。

此时，咱们应该：

First：在JDK目录下的bin文件夹下（C:\Program Files\Java\jdk1.8.0_71\bin），先看看有没有keytool.exe和jarsigner.exe文件，这两个程序用于给APK签名，签名之后便可发布。

Second：将Ionic生成的文件先命名为app.apk，而后复制一份当前的bin目录里，执行命令1，生成本身的签名文件，名为:zhangqiang.keystrore，别名也是这个，有效期20000天，仅仅在第一次生成签名文件，之后不须要。

执行完命令1，继续执行命令2便可完成签名打包。

命令1：生成签名密钥

/* 使用工具, 签名： -genkey表示构建签名文件 -v 显示在dos窗口中 -alias表示签名包的别名 -validity 签名有效期(天) 姓名:填上，用你名字拼音全拼 城市:随便填，不填也行 国家: 随便填，不填也行 密码口令：敲的时候不动，是由于保护隐私，别当作你电脑死机！ */

在CMD窗口执行以下命令，输入秘钥确认便可生成签名文件 yourname.keystore:

keytool -genkey -v -keystore zhangqiang.keystore -alias zhangqiang.keystore -keyalg RSA -validity 20000

命令2：给文件签名

使用刚才生成的zhangqiang.keystore -signedjar 签名后的apk 签名以前的apk 签名包别

jarsigner -verbose -keystore zhangqiang.keystore -signedjar complete.apk app.apk zhangqiang.keystore

如上图所示，IONIC打包的文件为app.apk,签名后的文件为complete.apk，这时候，能够说，一个软件就诞生啦！

后续的软件压缩打包能够百度：jarsigner打包

5.疑难杂症

5.1 Without ·from· option PostCSS could generate wrong source map and will not find Browserslist config. Set it to CSS file path or to undefined to prevent this warning.

出现这个提示，说明配置不正确。

解决方法：

在“/node_modules/@ionic/app-scripts/dist/sass.js”路径的“sass.js”文件，在postcssOptions参数中添加“from: undefined”。添加后效果以下：

var postcssOptions = { from: undefined, to: path_1.basename(sassConfig.outFile), map: autoPrefixerMapOptions }; 

5.2 安卓SDK组件缺失/缺乏/不匹配

报文：

A problem occurred configuring project ':CordovaLib'. > You have not accepted the license agreements of the following SDK components: [Android SDK Build-Tools 26.0.2].

缘由:SDK构建工具和platform工具不匹配，或者有东西遗漏了，没下载。

解决：若是中途报错SDK出问题，请打开C盘/profiles/SDK/manager.exe，使用东软的镜像，根绝报错信息，来down对应的platform或者build包。

5.3 缺乏安卓构建/打包工具

报错报文：

Unhandled promise rejection (rejection id: 1): CordovaError: Could not find an installed version of Gradle either in Android Studio, or on your system to install the gradle wrapper. Please include gradle in your path, or install Android Studio (node:3444) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

缘由：缺乏安卓构建打包工具，报文提示你能够用Android Studio，也能够安装一个Gradle。

解决办法：

去http://services.gradle.org/distributions/ 下载 gradle-4.1-bin.zip，下载完成解压到和JDK,SDK相同的父目录，便于未来查找（C:\Program Files\gradle-4.1） 
配置相应的环境变量：

GRADLE_HOME=E:\software\gradle-3.0

PATH=%PATH%;%GRADLE_HOME%\bin

测试命令（查看版本）：gradle -v

完成上述任务后，从新运行Gitbash,而后 $ ionic cordova build android ,发现build成功，会自动下载gradle-4.1-bin.zip (初步猜想是由于本身的gradle路径不对，也多是没有被项目依赖，可是项目在全局空间中发现gradle环境，所以本身要下载gradle来依赖。)

感谢收看。