Wepy微信小程序框架项目启动与配置教程

1. 项目目录结构及介绍

在克隆或下载 Wepy微信小程序框架项目后，您会看到以下目录结构：

wepy-wechat-demo/
├── dist/                # 构建目录，存放编译后代码
├── src/                 # 源码目录
│   ├── components/      # 公共组件目录
│   ├── pages/           # 页面目录
│   ├── app.js           # 小程序逻辑
│   ├── app.json         # 小程序公共设置
│   ├── app.wxss         # 小程序公共样式表
│   └── ...              # 其他源码文件或目录
├── .gitignore           # 忽略文件列表
├── .wepy/               # wepy 配置目录
│   ├── page.js          # 页面配置
│   └── ...              # 其他配置文件
├── package.json         # 项目依赖配置文件
└── ...                  # 其他项目文件或目录

• dist/：构建目录，用于存放编译后的小程序代码，通常不需要直接修改此目录内容。
• src/：源码目录，包含项目的主要代码。
  • components/：存放可复用的组件，便于在不同的页面或场景中使用。
  • pages/：存放小程序的各个页面相关文件，每个页面通常由四个文件组成：index.wpy、index.js、index.json、index.wxss。
  • app.js：小程序逻辑。
  • app.json：小程序公共设置，如页面路径、窗口表现等。
  • app.wxss：小程序公共样式表，定义全局样式。
• .gitignore：指定在执行 git 操作时应该忽略的文件或目录。
• .wepy/：Wepy 配置目录，存放 Wepy 的相关配置文件。
• package.json：项目依赖配置文件，定义项目依赖、脚本等。

2. 项目的启动文件介绍

在 Wepy微信小程序框架项目中，启动文件主要是 src 目录下的 app.js 文件。

app.js 是小程序的逻辑文件，用于编写全局的逻辑，如全局变量、生命周期函数等。以下是一个基本的 app.js 结构示例：

App({
  onLaunch: function () {
    // 小程序初始化完成时触发，全局只触发一次
  },
  onShow: function (options) {
    // 小程序启动或从后台进入前台显示时触发
  },
  onHide: function () {
    // 小程序从前台进入后台时触发
  },
  onError: function (msg) {
    // 小程序发生脚本错误或 API 调用报错时触发
  },
  globalData: {
    // 定义全局变量
  },
  // ... 其他自定义函数或方法
})

3. 项目的配置文件介绍

在 Wepy微信小程序框架项目中，主要的配置文件位于 .wepy 目录下，以及根目录下的 package.json。

• .wepy/page.js：这是 Wepy 的页面配置文件，可以定义页面相关的配置，如页面路径、页面级别的配置等。

page.js 示例：

module.exports = {
  'pages/index/index': {
    config: {
     navigationBarTitleText: '首页'
    }
  },
  // ... 其他页面配置
}

• package.json：这个文件定义了项目的依赖、脚本和配置等信息。在 scripts 部分，可以定义一些常用的命令，例如启动开发服务器、构建项目等。

package.json 中的 scripts 示例：

{
  "scripts": {
    "dev": "wepy build --watch",
    "build": "wepy build"
    // ... 其他脚本命令
  },
  // ... 其他配置
}

通过以上介绍，您应该对 Wepy微信小程序框架项目的目录结构、启动文件和配置文件有了基本的了解，可以开始进行项目的开发工作了。