/auto_example_9x

auto.pro 9.x框架的使用示例

Primary LanguageJavaScriptMIT LicenseMIT

auto-template-default

template without UI for auto.pro

使用说明

安装

在本项目的根目录（与本文文件同一目录）下执行npm i

配置

默认以src/index.js文件为源码入口，其将被编译为dist/app.js。此dist/app.js既能以单脚本方式运行，也能以项目方式运行。 以下是一些可能用到的配置项：

  • 项目主入口
    project.json -> mainScriptFile可以指定项目主入口，当使用运行项目指令，或以项目方式打包成 APK 时，将执行该文件。本模板默认使用dist/app.js为项目主入口。

  • 源码入口和出口
    入口默认为src/index.js，其将被编译为出口文件dist/app.js，可以在webpack.config.js -> config -> entry里进行配置，以默认模板为例，app就是出口文件名，./src/index.js就是入口路径。可以添加多个键值对来生成多个出口。

// webpack.config.js
const config = {
    entry: {
        app: "./src/index.js",
        // custom1: './src/xxx.js'
        // custom2: './src/xxxx.js'
    }

  • UI 模式
    如果需要使用 UI 模式，需要在webpack.config.js -> compilePlugin -> ui数组里指定，文件名应与出口文件名一致。
    如，上方示例的出口文件名为app，则在ui数组里填app即可将其设为 UI 模式。

  • AES 加密
    为了保证热更新的文件传输安全，常常需要使用 AES 加密源码，在webpack.config.js -> compilePlugin里设置encode: {key: 16位密钥}就会将出口文件以AES/ECB/PKCS7padding方式进行加密，解密时可参考以下代码

var source = $crypto.decrypt(
    files.read("dist/app.js", "utf8"),
    new $crypto.Key(你的密钥),
    "AES/ECB/PKCS7padding",
    {
        input: "base64",
        output: "string",
    }
)
files.write("dist/main.js", source)
  • 出口类型
    默认使用var输出类型，此类型可直接以单脚本或项目主入口方式启动，但是无法被其他 JS 文件引用（也就是无法 require）。如果你希望出口文件能被引用，比如制作自己的通用模块，可以将webpack.config.js -> output -> libraryTarget设为commonjs2。

编译

  • 开发模式
    执行npm start会以开发模式进行编译，此模式将一直监听src目录下的文件修改，并即时生成新的编译文件。同时你将能看到模块的结构分析，以及比较明确的报错位置，但是编译的产物会比较大。（可以使用ctrl-c结束运行）
  • 生产模式
    执行npm run build会以生产模式进行编译，得到一份压缩、混淆处理后的编译文件，此模式不会对src进行修改监听。

运行

在 vscode 里按F1会打开命令输入框，选择运行项目(Run Project)或运行脚本(Run)即可运行。

其他

如有疑问、建议或意见，可访问github提交 issue，或加 QQ 群 1019208967。

LICENSE

MIT.