ionic3項目從基礎安裝到打包apk

這是我第一次寫關于技術的文章,一方面是怕自己時間久了忘記,另一方面也是避免像我一樣的初學小白踩坑出不來。文章內可能引用了網上某些大神的經驗以及描述,感謝他們的分享,相同之處還望見諒。

廢話不多說,直接上干貨,我的電腦是win10系統(tǒng),所以就按照我的系統(tǒng)來講解了!

一,開發(fā)前需要軟件的準備 (文章所提到的軟件,文章最底部有提供)

????1,nodejs環(huán)境安裝(這個是先決條件,我的項目安裝的是 node-v10.14.1-x64)

????2,jdk安裝 (java的開發(fā)基礎類庫 jdk-8u71-windows-x64)

????3,SDK安裝(安卓開發(fā)集成包,集成了安卓的開發(fā)工具,插件,API等)

????4,gradle( Java的Weboack ,支撐app的編譯,打包的流程,我項目安裝的是 Gradle 4.1)?

二,編譯時需要的工具

????1,GitBush(我自己挺喜歡的一個工具,代替win系統(tǒng)cmd很好的軟件)我提供了Git安裝包,可直接安裝鼠標右鍵使用

? ? 2,Window系統(tǒng)自帶的cmd(建議管理員運行,因為有些命令需要管理員權限才能正常運行)

? ? 3,VSCode(微軟推出的一款很不錯的IDE,個人感覺和Sublime很像,界面很友好,需要什么插件直接搜索下載安裝就行。

? ? ? ? ? 這里主要是用到了它自帶的“終端”功能,ctrl + shift + y 的組合鍵打開,和Win系統(tǒng)的cmd類似,建議使用這種在IDE環(huán)境

? ? ? ? ? 內操作命令方式來玩)

三,所需要環(huán)境的安裝配置

? ? 1,安裝nodejs ,順帶連npm都安裝了,官網下載后直接Next安裝就行,實在不會的請看?http://m.itdecent.cn/p/03a76b2e7e00

????2,?jdk安裝,根據自己電腦的系統(tǒng)選擇x86和行x64的版本,按照提示安裝,目錄最好為 C:\Program Files\Java(x64系統(tǒng))

? ? ? ? ? ?或者?C:\Program Files(x86)\Java?(x86系統(tǒng))完成后cmd輸入?java -version 驗證是否安裝成功

? ? ? ? ?只要出來 java version 等信息,表示安裝沒有問題,可以進行下一步了

? ? 3,sdk (需要配置環(huán)境變量)

? ? ? ? ? 3.1 根據我提供的下載連接下載sdk后,解壓sdk 放在 C:\Program Files\Java 目錄下

? ? ? ? ? 3.2 配置環(huán)境變量,我的電腦——右鍵屬性——高級系統(tǒng)設置——環(huán)境變量

? ??????????????在下面的環(huán)境變量中,新建,鍵值對如下:name: ANDROID_HOME? ? ? key: C:\Program Files\SDK\androidsdk

? ? ? ? ? ? ? ? 如圖所示:


? ? ? ? ? ? ? ? ?然后在path中,全局聲明一下,將 ;%ANDROID_HOME%\tools 綴在最后面,前面有【;】分隔符。

? ? ? ? ? ? ? ? ?(注:win 10 系統(tǒng)不需要分號,SDK,JDK也是一樣)。添加android-sdk下的tools與platform-tools到path路徑下

? ? ? ? ? ? ? ? ?見下圖


? ? ? ? ? ? ? ? ?然后運行CMD,輸入android 和 adb命令 ,如果出現一大堆指令,說明你的SDK安裝無誤,并且環(huán)境變量配置OK。

? ? ? ? ? ? ? ? ?見下圖:


4,安裝gradle

? ? ? 安裝gradle到C:\Program Files 下然后添加系統(tǒng)變量,見下圖


完成后,添加路徑到path變量中,見下圖


添加完成后,cmd輸入 gradle -v來驗證是否成功

5,安裝python

? ? 安裝python2.7到C盤目錄下,同時設置path路徑,見下圖

? ? 安裝完成后cmd輸入python來驗證是否成功


6,打開android-sdk下的SDK Manager (打開后直接進入界面,網上有說要在tools選項卡中選擇options,然后配置國內鏡像,但是我配置后,發(fā)現在packages選項卡中點擊reload重載時,不能展示sdk列表,所以我沒有配置國內鏡像,直接就出來sdk列表了。有的小伙伴要是默認打開沒有加載sdk列表,那就配置下國內鏡像吧,tools選項卡中選擇options,server處填寫mrrors.neusoft.edu.cn,port處填寫 80,勾選Other處的Force https:// xxxxxxxxx,然后回到packages選項卡中點擊reload重載,就會出現sdk列表)

先勾選如下圖的三個Tools,一個SDK platform

分別是 Android SDK Tools,Android SDK platform-tools,Android SDK Build-tools,SDK platform 見下圖


注: 這里有個大坑,我爬了一天才出來,咱們先扯扯這個坑,這里SDK platform一定要結合項目平臺選擇正確,否則會出現命令打包后,ionic serve 瀏覽器可以訪問接口數據,debug包安裝真機后,不能訪問數據的坑。不能訪問數據的具體呈現為,所有接口返回 status:0,url: Null,你說坑不坑? 我查了很多資料,有的說是平臺問題,有的說是cordova插件白名單的問題,還有說別的問題,但是大致上以這倆原因為主,那我就試試唄(其實我認為還是平臺沒匹配好造成的)我先查看了下cordova的插件有沒有白名單,具體查詢命令為:cmd輸入 cordova?plugin?ls 結果還真有?cordova-plugin-whitelist 于是我卸載掉再安裝,打包裝機測試,哎,還是不能訪問數據。這條路走不通,我又開始折騰SDK Manager 安裝SDK,裝來裝去還是不對(其實我對這些也不太明白,瞎貓抓耗子唄,能有啥辦法),最后,我想起來,可能是我之前安裝的cordova-android版本較現在安裝的舊,現在安裝的是@9.0.0,之前是@6.4.0,于是我趕緊查看版本信息,命令: cordova platforms list 果然是9.0.0,趕緊執(zhí)行命令 cordova platform remove android 移除平臺,再?cordova?platform?add android@6.4.0 安裝6.4.0版本的,最后debug打包,安裝到真機后訪問數據還是失敗,仔細看了下報錯的信息,說是沒有 SDK platform API 26的授權,于是打開SDK?Manager卸載了? SDK platform API 27 安裝了SDK?platform API 26 繼續(xù)打包裝機,果然可以訪問數據了,折騰了一天,總算搞定了,這也證明了我當初的懷疑是正確的,的確是安裝的cordova-android平臺與SDK不匹配導致的問題。

四,項目開始前需要安裝的步驟都已經完成了,現在進行項目的創(chuàng)建,運行,以及打包了

1,創(chuàng)建項目

? ? 安裝ionic指定版本 ,我用的是Ionic CLI 4.12.0? 命令 npm install -g ionic@4.12.0? ? ?cmd輸入 ionic -v 驗證

? ? 安裝cordova指定版本 ,我用的是cordova 8.1.2 命令?npm install -g cordova@8.1.2? ? cmd輸入 cordova -v 驗證

? ? 當然也可以直接擼?npm install -g cordova ionic 命令來直接安裝 ionic cordova


執(zhí)行完ionic cordova的安裝后,通過cmd 來輸入?ionic start app tabs(GitBush進入到項目目錄下輸入)來創(chuàng)建我們的ionic項目

這個命令包含了tabs? 是指要創(chuàng)建一個包含tabs的app項目,根據自己項目的實際需要選擇,具體查看ionic3 CLI文檔

執(zhí)行完命令后,稍等片刻,瀏覽器自動彈出預覽界面(Chrome瀏覽器),并且支持熱更新,如下圖所示


這里的圖示引用我自己的項目,沒有創(chuàng)建新的app,示意執(zhí)行命令?ionic start app tabs 后Chorme 打開ionic 的界面

由此也證明了ionic cordova安裝都沒什么問題

五,打包項目(此處為Android打包)

執(zhí)行命令?ionic cordova build android 默認是打的是debug包,要打簽名包就帶上后綴?ionic cordova build android --release

若是項目第一次打包的話,時間可能會久一點,具體見下圖


Build Successful? 構建成功(失敗是 Build Fail 。假如失敗的話,請仔細查看cmd的報錯信息)

此次打包時間大致為1m 5s,生成的app名字為 android-debug.apk 位置在項目目錄下 platform/android/build/outputs/apk/debug內

此時就可以手機安裝這個debug的apk了,至于后面如何簽名release包,不在本次教程范圍內,有興趣的同學請自行百度!

注:文章所提到的安裝依賴,我提供下我的百度云下載鏈接:點這里獲取

提取碼:7rcu

如果這篇文章能幫助到你,我很榮幸,要是有錯誤的地方,還請指正出來,多包涵!

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容