2. 环境准备:注册小程序账号、开通云开发、创建第一个云开发项目
好,咱们正式开始动手了。这一章说白了就是「搭台子」——把开发环境准备好。我见过不少新手卡在这一步,要么账号注册出问题,要么云开发开通失败。别急,跟着我的节奏一步步来,半小时内你就能跑起来第一个云开发项目。
2.1 注册小程序账号
首先,你得有个微信小程序账号。这玩意儿是免费的,但流程上有点小坑。
打开微信公众平台官网(mp.weixin.qq.com),点击右上角的「立即注册」。在类型选择里,记得选「小程序」,别选成「服务号」或「订阅号」——我刚开始就犯过这错,注册完发现不对,又得重新来。
注册流程分三步:
- 填写邮箱和密码——用没注册过微信公众平台的邮箱,一个邮箱只能绑定一个小程序。
- 激活邮箱——去邮箱里点链接,这一步很简单。
- 填写主体信息——个人开发者选「个人」,企业开发者选「企业」。个人注册只需要身份证信息,企业需要营业执照。
提交后,审核通常几分钟到几小时不等。个人账号一般很快,我最快一次5分钟就通过了。
2.2 获取 AppID
账号注册成功后,登录后台,在「开发」->「开发设置」里,你能看到一个小程序 AppID。这东西很重要,相当于你小程序的身份证号。后面创建项目、调用云开发API,全都离不开它。
重要提醒:AppID 是敏感信息,别随便发到公开场合。我曾经在GitHub上不小心提交了包含AppID的代码,结果被人拿去乱调用,白白消耗了我的云资源配额。
2.3 开通云开发
有了账号和AppID,接下来就是开通云开发环境。这一步很多人会忽略,以为装了开发者工具就能直接用云开发——其实不是的。
在微信公众平台后台,左侧菜单找到「云开发」->「云开发环境」,点击「开通」。这时候会让你选择环境名称,我建议用 prod(生产环境)和 dev(开发环境)来命名。个人习惯是先用 dev 做测试,稳定了再创建 prod。
开通时要注意:
- 每个小程序账号可以创建两个环境(基础版)
- 环境一旦创建,名称不能修改
- 免费额度足够个人学习和小型项目使用
2.4 下载并安装开发者工具
账号和环境都准备好了,接下来装开发工具。去微信开发者工具官网下载最新版。我个人推荐下载「稳定版」,别追「预览版」——预览版有时候会有奇怪的bug,影响学习心情。
安装过程很简单,一路下一步就行。Windows用户注意安装路径别带中文,Mac用户直接拖到Applications文件夹。
2.5 创建第一个云开发项目
工具装好了,咱们来创建第一个项目。打开开发者工具,点击「新建项目」:
- 项目名称——随便起,比如
my-cloud-app - 目录——选一个你记得住的位置,别放桌面,也别放C盘
- AppID——填刚才获取的那个
- 开发模式——选「小程序」
- 后端服务——这里要选「微信云开发」
点击确定后,工具会自动生成一个带云开发模板的项目。你会看到左侧有 cloudfunctions 文件夹,这就是云函数存放的地方。右侧模拟器里已经有一个简单的页面了。
2.6 验证云开发是否可用
项目创建好了,怎么知道云开发真的能用了?我教你一个最简单的验证方法。
在开发者工具里,找到 cloudfunctions 文件夹,右键点击「新建云函数」,命名为 hello。工具会自动生成一个 index.js 文件,里面有一段示例代码:
// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init()
const db = cloud.database()
// 云函数入口函数
exports.main = async (event, context) => {
return {
message: 'Hello from cloud!',
time: new Date()
}
}
右键点击这个云函数,选择「上传并部署」。部署成功后,在页面的 onLoad 里调用它:
// 在页面的 js 文件中
Page({
onLoad() {
wx.cloud.callFunction({
name: 'hello',
success: res => {
console.log('云函数调用成功', res)
},
fail: err => {
console.error('调用失败', err)
}
})
}
})
打开调试器的Console面板,如果看到「云函数调用成功」和返回的数据,恭喜你——环境准备全部完成!
总结一下:注册账号 -> 获取AppID -> 开通云开发 -> 安装工具 -> 创建项目 -> 验证云函数。这六步走完,你的云开发环境就彻底准备好了。下一章咱们开始真正写代码,搭建商业后台的核心功能。
说实话,环境准备这一步最磨人。但一旦跑通了,后面就顺了。我当年第一次配环境,光AppID就找了好久,后来才发现原来藏在「开发设置」里。你现在跟着我的步骤走,应该十分钟就能搞定。