https://github.com/wzs28150/cool-weapp
Cool小程序框架
https://github.com/wzs28150/cool-weapp
Last synced: 7 days ago
JSON representation
Cool小程序框架
- Host: GitHub
- URL: https://github.com/wzs28150/cool-weapp
- Owner: wzs28150
- Created: 2019-06-10T14:41:26.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-06T20:19:11.000Z (over 2 years ago)
- Last Synced: 2023-03-05T17:23:24.833Z (about 2 years ago)
- Language: CSS
- Homepage:
- Size: 1.65 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Cool小程序框架
使用 `webpack`, `babel`, `scss` 开发的微信／支付宝小程序项目脚手架
## 功能
* 支持引用 `node_modules` 模块
* 支持通过配置 `alias` 来避免 `../../../` 之类的模块引用
* 通过 `babel` 支持更丰富的 `ES6` 兼容，包括 `async/await`
* 内置 `promise` 和 `lodash`（`lodash` 按需引入相应模块，不会全部引入）
* 使用 `scss` 编写 `.wxss` 文件，内置了一些有用的 `mixins` 和 `extends`
* 提供 `__DEV__` 和 `process.env.NODE_ENV` 全局常量辅助开发
* 支持自动编译为微信和支付宝小程序
* 提供 `__WECHAT__` 和 `__ALIPAY__` 全局常量来判断是微信小程序或支付宝小程序
* 通过命令行快速创建微信小程序页面
* 支持在 `production` 环境下压缩代码
## 开始使用
确保安装了 [Node.js](https://nodejs.org/) (>= `v4.2`) 和 [yarn](https://yarnpkg.com) 或 [npm](https://www.npmjs.com/package/npm)
1. `git clone` 此项目
2. 通过命令行工具 `cd` 到这个目录，执行 `yarn` 安装依赖模块
3. 执行 `yarn start` 开始开发
4. 通过微信开发者工具，添加 `dist/wechat` 目录到项目上
## 内置命令
* `yarn start` 启动 `webpack` 开发微信小程序项目，能监听文件变化自动重新编译
* `yarn start:alipay` 启动 `webpack` 开发支付宝小程序项目，能监听文件变化自动重新编译
* `yarn build` 编译生成 `production` 环境的代码到 `dist/wechat` 和 `dist/alipay`
* `yarn lint:build` 执行 `yarn build` 命令，并使用 eslint 和 stylelint 来校验代码规范
* `yarn prettier` 执行 `prettier` 来格式化 src 目录下的代码
* `yarn create-page` 快速创建微信小程序页面（更多 `create-page` 的用法，请查看 [create-wxapp-page](https://github.com/cantonjs/create-wxapp-page)）
## 兼容微信和支付宝小程序
开发者可以选择一套源代码来开发微信和支付宝小程序，这脚手架支持自动编译 `wxml` 为 `axml`，转换 `wx:attr` 为 `a:attr`，转换 API `wx` 为 `my`，反之亦然。但个别接口在平台上也略有差异，开发者可以通过 `__WECHAT__` 或 `__ALIPAY__` 来动态处理。
## 文件复制
如果 `wxml` 或 `axml` 有动态引入文件（如 `src="{{'images/' + type + '.png'}}"`），webpack 将不能动态引入，因此会导致打包后可能会存在缺失文件问题。
遇到这种情况，可以通过 [copy-webpack-plugin](https://github.com/webpack-contrib/copy-webpack-plugin) 解决，把整个 `images` 目录复制到 `dist` 下即可。
本脚手架已经内置这个插件。为了方便使用，还可以通过在 `package.json` 里增加一个 `copyWebpack` 的字符串数组，来实现目录或文件自动复制。例如：
**package.json**
```json5
{
// ...
"copyWebpack": ["images", "icons"]
}
```
通过执行 `yarn start` 或 `yarn build`，`src/images` 和 `src/icons` 目录会自动复制到 `dist/wechat/images` 和 `dist/wechat/icons` 目录（支付宝小程序同理）。
## 更新日志
[Changelog](/CHANGELOG.md)
## 小程序登陆流程
## 项目目录
``` bash
.
+-- dist(编译后最终小程序文件所在目录)
| +-- wechat(编译后最终小程序文件)
+-- src(项目编辑目录)
| +-- api(接口目录)
| | +-- config.js(接口设置)
| | +-- common.js(公共接口)
| +-- components(组件目录)
| +-- images(图片目录)
| +-- pages(页面目录)
| +-- styles(基础样式scss目录)
| +-- utils(封装的一些函数目录)
| +-- wxs(wxs小程序脚本语言目录)
| +-- app.js(入口文件)
| +-- app.json(入口配置文件)
| +-- app.scss(一些公共样式文件)
```
## 维护日志及下载
日期|更新内容|下载
:---:|:---:|:---:
2020.01.06|1. 优化api接口 所有接口在api文件夹下统一管理
2. 优化tabbar页面为swiper切换 tabbar页面以组件形式引入
3.解决tabbar页面数据更新问题|[V0.0.1 下载]( https://github.com/wzs28150/cool-weapp/archive/master.zip "cool-weapp").
## License
MIT