微信小程序快速入门案例教程

337 阅读4分钟

快速入门微信小程序:

  1. 注册账号

    • 访问微信公众平台,注册成为小程序开发者。
  2. 获取开发工具

  3. 创建小程序项目

    • 在开发者工具中创建新的小程序项目,填写AppID(如果没有AppID,需要先在微信公众平台注册小程序并获取)。
  4. 学习基础

    • 了解小程序的基本结构,包括:app.json(全局配置文件)、pages(页面目录)、utils(工具函数)、components(自定义组件)等。
  5. 编写代码

    • 使用WXML(微信标记语言)、WXSS(微信样式表)、JavaScript和可能的JSON配置文件来构建你的小程序。
  6. 调试与测试

    • 在开发者工具中进行代码调试,使用模拟器预览小程序的运行效果。
  7. 权限配置

    • 根据需要配置小程序的权限,如获取用户信息、地理位置等。
  8. 发布小程序

    • 在微信公众平台提交审核,审核通过后发布小程序。
  9. 推广与维护

    • 通过各种渠道推广你的小程序,同时根据用户反馈进行维护和更新。

学习资源:

开发注意事项:

  • 遵守微信小程序的开发规范和政策。
  • 考虑用户体验,确保小程序的响应速度和交互设计。
  • 测试在不同设备和操作系统上的兼容性。

微信小程序工程结构

一个典型的小程序工程结构示例:

project/
├── app.js
├── app.json
├── app.wxss
├── pages/
│   ├── index/
│   │   ├── index.js
│   │   ├── index.json
│   │   ├── index.wxml
│   │   └── index.wxss
│   ├── logs/
│   │   ├── logs.js
│   │   ├── logs.json
│   │   ├── logs.wxml
│   │   └── logs.wxss
│   └── ...
├── utils/
│   ├── util.js
│   └── ...
├── components/
│   ├── my-component/
│   │   ├── my-component.js
│   │   ├── my-component.json
│   │   ├── my-component.wxml
│   │   └── my-component.wxss
│   └── ...
├── images/
│   ├── icon.png
│   └── ...
├── audio/
│   ├── bgm.mp3
│   └── ...
├── video/
│   ├── intro.mp4
│   └── ...
├── lib/
│   ├── ...
├── project.config.json
└── sitemap.json
  1. 项目根目录:存放项目的所有文件。

  2. pages:存放页面文件,每个页面由四个文件组成,分别是:

    • .js:页面逻辑文件,使用JavaScript编写。
    • .wxml:页面结构文件,使用WXML编写。
    • .wxss:页面样式文件,使用WXSS编写。
    • .json:页面配置文件,用于页面的配置。
  3. utils:存放工具类文件,通常用于存放一些公共的函数或类。

  4. components:存放自定义组件,每个组件也是一个小的页面结构,可以复用。

  5. app.js:小程序逻辑文件,用于全局逻辑定义。

  6. app.json:小程序全局配置文件,用于设置小程序的窗口表现、设置网络超时时间等。

  7. app.wxss:小程序全局样式文件。

  8. index.js:小程序入口文件,通常用于定义App实例。

  9. index.json:小程序入口配置文件,用于配置小程序的页面路径、窗口表现等。

  10. icon.png:小程序图标,用于小程序的识别。

  11. project.config.json:项目配置文件,用于设置小程序的编译配置、条件编译等。

  12. sitemap.json:用于配置小程序的页面收录情况,可以指定哪些页面被搜索引擎收录。

  13. lib:存放第三方库文件。

  14. imageassets:存放图片资源。

  15. audiosound:存放音频资源。

  16. video:存放视频资源。

小程序入门案例

1. 创建项目

首先,在微信开发者工具中创建一个新的小程序项目。

2. 项目结构

项目结构如下:

hello-world/
├── app.js
├── app.json
├── app.wxss
├── pages/
│   ├── index/
│   │   ├── index.js
│   │   ├── index.json
│   │   ├── index.wxml
│   │   └── index.wxss
├── project.config.json
└── sitemap.json

3. 编写代码

3.1 app.js

// app.js
App({
  onLaunch: function() {
    // 当小程序初始化完成时,会触发 onLaunch(全局只触发一次)
    console.log('App Launch');
  },
  onShow: function(options) {
    // 当小程序启动,或从后台进入前台显示,会触发 onShow
    console.log('App Show');
  },
  onHide: function() {
    // 当小程序从前台进入后台,会触发 onHide
    console.log('App Hide');
  }
});

3.2 app.json

// app.json
{
  "pages": [
    "pages/index/index"
  ],
  "window": {
    "navigationBarTitleText": "Hello World"
  }
}

3.3 app.wxss

/* app.wxss */
/** {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}*/

3.4 pages/index/index.js

// pages/index/index.js
Page({
  data: {
    message: 'Hello World'
  },
  onLoad: function(options) {
    // 页面创建时执行
    console.log('Page Load');
  },
  onShow: function() {
    // 页面显示时执行
    console.log('Page Show');
  },
  onHide: function() {
    // 页面隐藏时执行
    console.log('Page Hide');
  }
});

3.5 pages/index/index.json

// pages/index/index.json
{
  "navigationBarTitleText": "首页"
}

3.6 pages/index/index.wxml

<!-- pages/index/index.wxml -->
<view class="container">
  <text>{{message}}</text>
</view>

3.7 pages/index/index.wxss

/* pages/index/index.wxss */
.container {
  display: flex;
  justify-content: center;
  align-items: center;
  height: 100%;
  background-color: #f8f8f8;
}

text {
  font-size: 24px;
  color: #333;
}

4. 运行和调试

  1. 保存所有文件:确保所有文件都已保存。
  2. 预览:点击微信开发者工具中的“编译”按钮,编译项目。
  3. 调试:在模拟器中查看效果,点击“Hello World”文本。

5. 效果展示

运行后,你应该在模拟器中看到如下界面:

Hello World