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

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

2025-04-26 13:46:22作者:冯梦姬Eddie

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.wpyindex.jsindex.jsonindex.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微信小程序框架项目的目录结构、启动文件和配置文件有了基本的了解,可以开始进行项目的开发工作了。

登录后查看全文
热门项目推荐