使用HbuilderX,将vue-cli4打包的项目转换为手机app的方法

2019.12.13
评论

一.创建app项目

1.打开HbuilderX,新建项目->5+app->填写路径以及名称、选择默认模板

2.配置app项目格式,配置方法在HbuilderX中打开创建项目内的manifest.json文件

  1. 基础配置:选择填写,勾选应用是否全屏显示
  2. 图标配置:这里的图标配置决定了你的app在手机、平板等设备上的图标,图片采用png格式,具体因人而异
  3. 启动图配置:取消勾选 '启动界面显示等待雪花',勾选 '自动关闭启动界面',启动图配置和图标配置大概相同,具体因人而异
  4. SDK配置:第三方的sdk,选择性勾选
  5. 模块权限配置:选择性勾选
  6. 其他配置:都有详细介绍,选择性更改

二.配置vue-cli4的文件

1.修改router模式为hash,history模式不可以,原因不明

//找到自己创建的router管理文件,修改
 
new VueRouter({
	........,//这里为其他配置,不管
	mode: 'hash',
})

2.添加vue-cli配置文件vue.config.js

由于vue-cli对配置包的高度整合,我没有找到低版本本来在根目录存在的vue.config.js配置文件,所以这里自己创建,低版本用户如果有直接修改即可,以下配置来自于网上,具体内容选择写入,必要条件单独标明:

module.exports = {
    // 部署应用时的基本 URL 必写
    publicPath: process.env.NODE_ENV === 'production' ? './' : '/',
    // build时构建文件的目录 构建时传入 --no-clean 可关闭该行为
    outputDir: 'dist',
    // build时放置生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录
    assetsDir: '',
    // 指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径。
    indexPath: 'index.html',
    // 默认在生成的静态资源文件名中包含hash以控制缓存
    filenameHashing: true,
    // 构建多页面应用,页面的配置
    pages: {
        index: {
            // page 的入口
            entry: 'src/main.js',
            // 模板来源
            template: 'public/index.html',
            // 在 dist/index.html 的输出
            filename: 'index.html',
            // 当使用 title 选项时,template 中的 title 标签需要是 <title><%= htmlWebpackPlugin.options.title %></title>
            title: 'Index Page',
            // 在这个页面中包含的块,默认情况下会包含
            // 提取出来的通用 chunk 和 vendor chunk。
            chunks: ['chunk-vendors', 'chunk-common', 'index']
        },
        // 当使用只有入口的字符串格式时,模板会被推导为 `public/subpage.html`,并且如果找不到的话,就回退到 `public/index.html`。
        // 输出文件名会被推导为 `subpage.html`。
        subpage: 'src/main.js'
    },
    // 是否在开发环境下通过 eslint-loader 在每次保存时 lint 代码 (在生产构建时禁用 eslint-loader)
    lintOnSave: process.env.NODE_ENV !== 'production',
    // 是否使用包含运行时编译器的 Vue 构建版本
    runtimeCompiler: false,
    // Babel 显式转译列表
    transpileDependencies: [],
    // 如果你不需要生产环境的 source map,可以将其设置为 false 以加速生产环境构建
    productionSourceMap: true,
    // 设置生成的 HTML 中 <link rel="stylesheet"> 和 <script> 标签的 crossorigin 属性(注:仅影响构建时注入的标签)
 
    crossorigin: '',
    // 在生成的 HTML 中的 <link rel="stylesheet"> 和 <script> 标签上启用 Subresource Integrity (SRI)
    integrity: false,
    // 如果这个值是一个对象,则会通过 webpack-merge 合并到最终的配置中
    // 如果你需要基于环境有条件地配置行为,或者想要直接修改配置,那就换成一个函数 (该函数会在环境变量被设置之后懒执行)。该方法的第一个参数会收到已经解析好的配置。在函数内,你可以直接修改配置,或者返回一个将会被合并的对象
    configureWebpack: {},
    // 对内部的 webpack 配置(比如修改、增加Loader选项)(链式操作)
    chainWebpack: () => { },
    // css的处理
    css: {
        // 当为true时,css文件名可省略 module 默认为 false
        requireModuleExtension: true,
        // 是否将组件中的 CSS 提取至一个独立的 CSS 文件中,当作为一个库构建时,你也可以将其设置为 false 免得用户自己导入 CSS
        // 默认生产环境下是 true,开发环境下是 false
        extract: false,
        // 是否为 CSS 开启 source map。设置为 true 之后可能会影响构建的性能
        sourceMap: false,
        //向 CSS 相关的 loader 传递选项(支持 css-loader postcss-loader sass-loader less-loader stylus-loader)
        loaderOptions: { css: {}, less: {} }
    },
    // 所有 webpack-dev-server 的选项都支持
    devServer: {
        // open: false,
        // port: 8080,
        // // 跨域
        // proxy: {
        //     '/api/': {
        //         target: 'http://192.168.0.11/',
        //         changeOrigin: true
        //     }
        // }
    },
    // 是否为 Babel 或 TypeScript 使用 thread-loader
    parallel: require('os').cpus().length > 1,
    // 向 PWA 插件传递选项
    pwa: {},
    // 可以用来传递任何第三方插件选项
    pluginOptions: {}
}

三.合成打包

1.文件合成 将vue-cli打包完成后的文件dist,将里面的内容全部复制到创建的app项目根目录,重复的选择覆盖

2.文件上传打包 右键app项目目录->发现->原生app-云打包->弹出框配置打包文件

包类型:Android包或者ios包
证书:如果没有个人证书,则 使用公共测试证书
打包类型:如果直接安装使用的app,则使用 打正式包
原生混淆:按需勾选,默认不选
广告联盟:按需勾选,默认不选
换量联盟:按需勾选,默认不选

3.提交打包,会在HbuilderX的终端显示当前打包进度,打包完成后会显示apk下载地址