cordova+vue-cli4构建app并进行调试

2024-03-01 19:09:52

  • 欢迎加入前端交流群来获取视频资料以及前端学习资料：749539640 *

本文会详细的介绍如何使用cordova来打包vue项目，生成app（android）

你将学会：

  • 基于cordova构建vue项目app
  • 自定义app名字/图标/启页图片
  • 自动构建脚本

Cordova(中文官网详细介绍)是一个开源的移动开发框架。允许你用标准的web技术-HTML5,CSS3和JavaScript做跨平台开发,应用的实现是通过web页面，默认的本地文件名称是index.html
大体思路就是把打包好的vue项目放在cordova的Web App中来启动；我们开始吧

1.环境准备

2.验证环境

cordova+vue-cli4构建app并进行调试

  • 项目目录
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

cordova+vue-cli4构建app并进行调试

  • 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+vue-cli4构建app并进行调试
运行界面：
cordova+vue-cli4构建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项目界面：
    cordova+vue-cli4构建app并进行调试
  • 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

运行至手机界面：
cordova+vue-cli4构建app并进行调试

5.浏览器调试app

运行cordova run android后，app会装到手机上
谷歌浏览器输入：chrome://inspect/#devices
看到如下界面：
cordova+vue-cli4构建app并进行调试
找到自己的设备（手机中也需要运行app），点击inspect，接下来就可以调试样式了
cordova+vue-cli4构建app并进行调试

6.更换app图标以及app名字以及app启动页

先随便准备2张图片（图标以及启动页图片）

  • 6.1更改图标：

    cordova+vue-cli4构建app并进行调试
    进入文件夹：cordova/cordova-project/res/icon/android
    将图片进行替换即可（名字/图片格式推荐png）
    cordova+vue-cli4构建app并进行调试
    替换为：
    cordova+vue-cli4构建app并进行调试

  • 6.2更改启动页图片：
    cordova+vue-cli4构建app并进行调试
    安装splashscreen插件：
cd cordova-project
cordova plugin add cordova-plugin-splashscreen

进入文件夹：/cordova/cordova-project/res/screen/android
将图片进行替换即可,这里只替换了竖屏的（名字/图片格式推荐png）
cordova+vue-cli4构建app并进行调试
替换为
cordova+vue-cli4构建app并进行调试

  • 打开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>
  • 打包查看
    图标以及名字：
    cordova+vue-cli4构建app并进行调试
    启动页：
    cordova+vue-cli4构建app并进行调试

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 //调试至手机

8.vue中使用cordova,详情vue-cordova

上一篇：Framework7-vue + cordova，从创建项目到发布程序（Android、Web）


下一篇：Spring Cloud（Greenwich版）-05-Spring Cloud集成Ribbon（客