- 欢迎加入前端交流群来获取视频资料以及前端学习资料:749539640 *
本文会详细的介绍如何使用cordova来打包vue项目,生成app(android)
你将学会:
- 基于cordova构建vue项目app
- 自定义app名字/图标/启页图片
- 自动构建脚本
Cordova(中文官网详细介绍)是一个开源的移动开发框架。允许你用标准的web技术-html5,CSS3和javascript做跨平台开发,应用的实现是通过web页面,默认的本地文件名称是index.html
大体思路就是把打包好的vue项目放在cordova的Web App中来启动;我们开始吧
1.环境准备
- Java SDK 8(cordova最高支持到8)下载地址
- Gradle
- Cordova 8.0
- Node
- vue-cli
- Android Studio /Android SDK
2.验证环境
- 项目目录
cordova
│ cordova-project
│ my-app
这里把cordova项目和vue项目平级存放,也可以嵌套(自行看情况)
3.新建cordova项目
-
3.1新建cordova目录
-
3.2在cordova文件夹下新建cordova项目
mkdir cordova
cd cordova
cordova create cordova-project
-
3.3添加Android平台
cd cordova-project
cordova platform add android --save
要构建和运行App,你需要安装每个你需要平台的SDK。另外,当你使用浏览器开发你可以添加 browser平台,它不需要任何平台SDK。
-
3.4 检测你是否满足构建平台的要求:
cordova requirements
-
3.5打包app安装到手机上(前提是手机连上电脑并开启USB调试模式)
cordova run android
- 或者只是打包apk
cordova build android
apk生成目录:cordova-project/platforms/android/app/build/outputs/apk/debug/app-debug.apk
默认生成的cordova app 图标:
运行界面:
进行到这里的时候,cordova部分先告一段落,下面开始第二部分
4.新建vue项目(vue-cli)
cd cordova
vue create my-app
//配置里我们选择默认项就行default (babel, eslint)
cd my-app
npm install
npm run serve
-
4.1浏览器运行vue项目界面:
-
4.2打包vue项目
- 配置vue.config.js
- my-app目录下新建vue.config.js(这里只做路径配置,其他配置项可详情vue.config.js)
默认情况下,cordova create命令生成基于web的应用程序的骨骼,项目的主页是 www/index.html 文件。
\'use strict\'
module.exports = {
publicPath: \'./\',
//这个值也可以被设置为空字符串 (\'\') 或是相对路径 (\'./\'),这样所有的资源都会被链接为相对路径,这样打出来的包可以被部署在任意路径,也可以用在类似 Cordova hybrid 应用的文件系统中。
outputDir: \'../cordova-project/www\',
//将打包目录指向/cordova-projec下的www
productionSourceMap: false,
//如果你不需要生产环境的 source map,可以将其设置为 false 以加速生产环境构建。
}
- 配置好之后我们进行打包
npm run build
-
4.3打包apk安装到手机上
cd cordova-project
cordova run android
或者是打包apk
cd cordova-project
cordova build android
运行至手机界面:
5.浏览器调试app
运行cordova run android
后,app会装到手机上
谷歌浏览器输入:chrome://inspect/#devices
看到如下界面:
找到自己的设备(手机中也需要运行app),点击inspect,接下来就可以调试样式了
6.更换app图标以及app名字以及app启动页
先随便准备2张图片(图标以及启动页图片)
-
6.1更改图标:
进入文件夹:cordova/cordova-project/res/icon/android
将图片进行替换即可(名字/图片格式推荐png)
替换为:
-
6.2更改启动页图片:
安装splashscreen插件:
cd cordova-project
cordova plugin add cordova-plugin-splashscreen
进入文件夹:/cordova/cordova-project/res/screen/android
将图片进行替换即可,这里只替换了竖屏的(名字/图片格式推荐png)
替换为
- 打开
config.xml
-
6.3更改名字(name标签内的内容进行更改即可)
<name>vueApp</name>
-
6.4更改配置项
添加图标以及启动页,在 <platform name="android"> </platform>
添加如下代码
<platform name="android">
<allow-intent href="market:*" />
<icon density="ldpi" src="res/icon/android/icon-36-ldpi.jpg" />
<icon density="mdpi" src="res/icon/android/icon-48-mdpi.jpg" />
<icon density="hdpi" src="res/icon/android/icon-72-hdpi.jpg" />
<icon density="xhdpi" src="res/icon/android/icon-96-xhdpi.jpg" />
<splash density="port-ldpi" src="res/screen/android/screen-ldpi-portrait.png" />
<splash density="port-mdpi" src="res/screen/android/screen-mdpi-portrait.png" />
<splash density="port-hdpi" src="res/screen/android/screen-hdpi-portrait.png" />
<splash density="port-xhdpi" src="res/screen/android/screen-xhdpi-portrait.png" />
<preference name="ShowSplashScreenSpinner" value="false" /><!-- 启动页面淡入淡出的效果 -->
</platform>
- 打包查看
图标以及名字:
启动页:
7.自动构建脚本(shell)
每次打包需要执行如下命令,很麻烦
cd cordova/my-app
npm install
npm run build
cd ../cordova-project
cordova build android /cordova run android
我们可以在cordova目录下新建build.sh文件
#!/usr/bin/env bash
PLATFORM=android
#!1(not clean) 0(clean)
TYPE=build
#!(-d)debug build
TYPE=$1
function echo_action() {
INFO_START=\'\\033[1;36m\'
INFO_END=\'\\033[0m\'
echo -e "\\xF0\\x9F\\x90\\xB6 ${INFO_START}$1${INFO_END}"
}
function echo_info() {
INFO_START=\'\\033[1;32m\'
INFO_END=\'\\033[0m\'
echo -e "\\xF0\\x9F\\x92\\x9A ${INFO_START}$1${INFO_END}"
}
function echo_warn() {
INFO_START=\'\\033[1;33m\'
INFO_END=\'\\033[0m\'
echo -e "\\xF0\\x9F\\x92\\x9B ${INFO_START}$1${INFO_END}"
}
function echo_err() {
INFO_START=\'\\033[1;31m\'
INFO_END=\'\\033[0m\'
echo -e "\\xF0\\x9F\\x92\\x94 ${INFO_START}$1${INFO_END}"
}
function addAndroidPlatform() {
echo_action "Start add android platform ..."
cordova platform add android
if [ "$?" != "0" ]; then
return 1
fi
return 0
}
function installDependencesCordova() {
echo_action "Installing Cordova dependences ..."
npm install
echo_info " Cordova Dependences installed"
}
function installDependences() {
echo_action "Installing dependences ..."
echo_action "cd ./my-app"
cd ./my-app
npm install
echo_info "Dependences installed"
}
function buildWebapp() {
echo_action "Start building my-app..."
npm run build
echo_info "Build Command: npm run build"
}
function installPlugins() {
addAndroidPlatform
echo_info "Install App Updater plugin finished"
}
function buildApk() {
echo_action "Start building ..."
if [ "${TYPE}" == "debug" ]; then
cordova run android
echo_info "Build Command: cordova run android"
else
cordova build android
echo_info "Build Command: cordova build android"
fi
}
echo_info "Build for ${PLATFORM}"
if [ "${TYPE}" == "debug" ]; then
echo_info "Build Command: cordova run android"
else
echo_info "Build Command: cordova build android"
fi
installDependences
if [ "$?" == "0" ]; then
echo_info "All dependences have been installed successfully."
else
echo_err "Failed to install dependences."
fi
buildWebapp
if [ "$?" == "0" ]; then
echo_info "All things done successfully."
else
echo_err "Build failed."
fi
echo_action "cd ../cordova-project"
cd ../cordova-project
installPlugins
if [ "$?" == "0" ]; then
echo_info "All plugins have been installed successfully."
else
echo_err "Failed to install plugins."
fi
installDependencesCordova
if [ "$?" == "0" ]; then
echo_info "All dependences have been installed successfully.."
else
echo_err "Failed to install dependences."
fi
buildApk
if [ "$?" == "0" ]; then
echo_info "All things done successfully."
else
echo_err "Build failed."
fi
这样我们下次就可以
cd cordova
./build.sh build //打包apk
./build.sh debug //调试至手机