框架开发

小程序的开发除去常见的原生小程序语法的开发模式,还可以应用层框架开发,用类现代框架 (vue/react) 的语法去开发小程序,提升开发体验和解决跨平台的问题。本文主要讲解如何用常见的小程序框架开发百度小程序。

  • 由于开发者工具会 watch 项目文件修改,如果出现三方框架构建时变更大量文件而导致无法编译的情况,请尝试在三方框架的构建结束后重新打开项目。
  • 当使用第三方框架生成百度小程序的代码带有 source-map 时,建议关闭第三方框架生成代码的配置;否则开启 source-map 可能会引起编译失败。

Taro

第一步: 安装开发工具

安装 Taro 开发工具 @tarojs/cli;
使用 npm 或者 yarn 的方式都可以获取,也可以直接使用 npx(在 npm 5.2+ 下)

  1. $ npm install -g @tarojs/cli
  2. $ yarn global add @tarojs/cli

第二步: 初始化项目

使用命令创建模板项目

  1. $ taro init swan-taro

也可以参考 Taro 开发百度小程序示例

第三步: 安装依赖

进入项目目录,安装依赖

  1. $ npm install

第四步: 构建目标代码

去掉 —watch 将不会监听文件修改,并会对代码进行压缩打包

  1. # npm script
  2. $ npm run dev:swan // 开发模式
  3. $ npm run build:swan // 线上模式
  4. # 仅限全局安装
  5. $ taro build --type swan --watch
  6. $ taro build --type swan

第四步: 开发者工具打开项目

可以通过两种方式打开项目:
方式一:使用开发者工具打开生成的 dist 目录,进行调试、预览、上传;
方式二:使用 2.8.1 及以上版本开发者工具打开项目目录,同时进行以下配置,配置完成后,就可以在开发者工具中开发、调试、预览、上传。

  1. npm run build:swan
  2. project.swan.json文件中增加配置 "smartProgramRoot": "dist"(如果已有此配置,请忽略)
  3. 在项目信息面板中设置如下自定义预处理指令。
    • 编译前预处理: npm run dev:swan 并勾选 异步执行
    • 上传前预处理: npm run build:swan
  4. 重新打开项目

mpvue

第一步: 初始化项目

使用示例项目:

  1. $ git clone git@github.com:hucq/mpvue-platform-sample.git

也可以参考 mpvue 开发百度小程序示例

第二步: 安装依赖

进入项目目录,安装依赖

  1. $ npm install
  2. $ npm install mpvue@beta mpvue-loader@beta mpvue-template-compiler@beta

第三步: 构建目标代码

  1. $ npm run dev:swan // 开发模式
  2. $ npm run build:swan // 线上模式

第四步: 开发者工具打开项目

可以通过两种方式打开项目:
方式一:使用开发者工具打开生成的 dist/swan 目录,进行调试、预览、上传,
方式二:使用 2.8.1 及以上版本开发者工具打开项目目录,同时进行以下配置,配置完成后,就可以在开发者工具中开发、调试、预览、上传。

  1. npm run build:swan
  2. project.swan.json文件中增加配置 "smartProgramRoot": "dist/swan"(如果已有此配置,请忽略)
  3. 在项目信息面板中设置如下自定义预处理指令。
    • 编译前预处理: npm run dev:swan 并勾选 异步执行
    • 上传前预处理: npm run build:swan
  4. 点击编译按钮

WePY

第一步: 安装开发工具

安装 WePY 开发工具 wepy-cli;

  1. $ npm install -g wepy-cli@1.7.3-alpha6

第二步: 初始化项目

使用命令创建模板项目

  1. $ wepy init standard

也可以参考 WePY 开发百度小程序示例

第三步: 安装依赖

进入项目目录,安装依赖

  1. $ npm install

第四步: 构建目标代码

注:去掉 —watch 将不会监听文件修改,并会对代码进行压缩打包

  1. # 仅限全局安装
  2. $ wepy build -o baidu --watch
  3. $ wepy build -o baidu

第五步: 开发者工具预览

在百度开发者工具中选择打开项目目录下的dist目录,就可以在开发者工具中预览项目。

Okam

第一步:安装 CLI 工具

  • Node 安装(要求 Node >=8 && NPM >= 3),具体安装可以到官网下载
  • CLI 工具安装:
  1. npm install okam-cli -g

第二步:初始化项目

  1. okam init my-project
  2. cd my-project
  3. npm install

第三步:构建目标代码

代码说明
npm run dev带 watch 开发模式
npm run dev:clean删掉构建产物(不包括项目配置文件)并重新构建且带 watch 开发模式
npm run dev:server带 watch && 开发 Server 开发模式
npm run build删掉构建重新构建(没有 watch && 开发 Server)
npm run prod生产环境构建

第四步: 开发者工具打开项目

可以通过两种方式打开项目:
方式一:使用开发者工具打开生成的 dist 目录,进行调试、预览、上传,
方式二:使用 2.8.1 及以上版本开发者工具打开项目目录,同时进行以下配置,配置完成后,就可以在开发者工具中开发、调试、预览、上传。

  1. npm run prod
  2. project.swan.json文件中增加配置 "smartProgramRoot": "dist"(如果已有此配置,请忽略)
  3. 在项目信息面板中设置如下自定义预处理指令。
    • 编译前预处理: npm run dev 并勾选 异步执行
    • 上传前预处理: npm run prod
  4. 点击编译按钮

更多关于 Okam 使用,可以参考 Okam 文档