一、踏上小程序开发之旅前的准备
(一)小程序账号注册
- 开启注册流程
- 首先,在浏览器中打开 “微信公众平台”(微信公众平台)。进入平台后,你会看到右上角有一个 “立即注册” 按钮,点击它,这时会弹出可注册的 4 种账号类型供选择,我们要选择 “小程序” 账号进行申请。
- 填写注册信息
- 邮箱激活账号
- 注册成功后,系统会提示激活邮件已发送至你填写的注册邮箱。此时,登录邮箱,在收件箱中找到来自微信公众平台的邮件,点击邮件中的激活链接,完成账号激活。需要注意的是,在验证界面里,一个手机号只能注册 5 个小程序。
(二)完善小程序信息
- 登录管理后台
- 激活账号后,使用注册的邮箱作为登录账号,登录小程序管理后台。登录后,你会发现有许多需要完善的信息。
- 基本信息填写
- 小程序名称:这是用户识别你的小程序的重要标识,名称字符数需在 4 - 30 个字符之间,一个中文字等于 2 个字符。同时,要注意名称规则,确保名称不违反相关规定。例如,名称不能包含敏感词汇、侵权内容等。
- 小程序简称(选填):如果填写,简称将用于任务栏展示。简称需从当前名称中按顺序选取字符创建,长度为 4 - 10 个字符,一个中文字同样等于 2 个字符。
- 小程序头像:头像图片格式必须为 png、bmp、jpeg、jpg、gif 中的一种,不可大于 2M。建议使用 png 格式图片,以保持最佳效果,并且图片尺寸建议为 144px * 144px。头像不能涉及政治敏感与色情内容。
- 小程序介绍:简要介绍小程序的功能和特点,介绍内容需不含国家相关法律法规禁止的内容,字符数在 0 - 120 之间。
- 小程序类目选择
(三)其他准备事项(可选)
- 微信认证(可选但有优势)
- 配置服务器(多种方式可选)
(四)安装开发者工具
- 下载入口
- 登录微信公众平台后,进入小程序页面。在 “开发与服务” - “微信开发工具” 处,点击下载链接。
- 选择合适版本
- 微信开发者工具提供了稳定版、预发布版和开发版等不同版本供选择。对于新手来说,建议选择稳定版 Stable Build,其稳定性较高,适合日常开发。稳定版支持 Windows 7 及以上版本(从 1.06 开始不支持 Windows 7,建议开发者升级 Windows 版本),提供了 Windows 64 位、Windows 32 位、macOS x64、macOS ARM64 等多种操作系统版本的下载。根据你的电脑操作系统选择对应的版本进行下载。
- 安装过程
- 下载完成后,找到安装文件并双击运行,按照安装向导的提示完成安装。安装过程中,可选择安装路径等常规选项,一般保持默认设置即可。
二、开发者工具的深度使用
(一)创建项目
- 启动工具并登录
- 双击打开微信开发者工具,使用微信扫码登录。登录成功后,你将进入开发者工具的主界面。
- 项目信息填写
- 点击主界面中的加号创建项目。在弹出的创建项目窗口中,填写项目名称,名称可根据你的需求随意设定,例如 “helloworld”。接着选择项目路径,即指定项目在本地电脑中的存储位置,选择一个合适的本地文件夹。然后,输入注册小程序时获得的 AppID,如果没有 AppID,也可以选择 “无 AppID” 进行测试,但部分功能可能会受限。在后端服务选项中,根据你的需求选择是否使用云开发。如果不使用云开发(使用云开发需要花费一定成本且涉及腾讯云的云函数、服务器等),则选择 “不使用云服务”。模板选择方面,对于新手,建议选择 “js 基础版”,其他模板功能相对复杂,对初学者不太友好。最后点击 “创建” 按钮,即可成功创建一个小程序项目。
(二)工具界面与功能详解
- 主界面布局
- 微信开发者工具的主界面主要由菜单栏、工具栏、模拟器、编辑器和调试器组成。每个部分都承担着不同的功能,协同工作,帮助开发者高效地创建和调试小程序。
- 菜单栏功能
- 项目:用于新建项目、打开现有项目以及对项目进行管理操作。
- 文件:可进行新建文件、保存文件、关闭文件等基本文件操作,确保你的代码和配置文件能够及时保存和管理。
- 编辑:提供代码编辑功能,如对代码进行格式化,使代码结构更加清晰易读,提高代码编写效率。
- 工具:访问一些辅助工具,如代码检查工具、性能分析工具等,帮助开发者发现和解决代码中的问题,优化小程序性能。
- 界面:用于控制主界面中各部分(如模拟器、编辑器、调试器等)的显示和隐藏,根据你的工作需求灵活调整界面布局。
- 设置:对开发者工具的外观、快捷键、编辑器等进行个性化设置,提高开发体验。例如,你可以设置代码字体大小、颜色主题等。
- 微信开发者工具:可进行切换账号、更换开发模式、启动调试等操作,方便开发者在不同账号和开发模式之间切换,适应不同的开发场景。
- 工具栏快捷按钮
- 个人中心:位于工具栏最左侧,显示当前登录用户的用户名和头像,方便快速识别当前用户身份。
- 模拟器、编辑器、调试器:用于快速控制相应工具的显示和隐藏,通过点击按钮可以在需要时快速切换到相应的工作区域。
- 云开发:如果在创建项目时选择了使用云开发,点击此按钮可进入云开发控制台,进行云函数、数据库、存储等云服务的管理和开发。
- 模式切换下拉菜单:可在小程序模式、多端应用模式和插件模式之间进行选择,根据项目类型选择合适的模式进行开发。
- 编译下拉菜单:用于切换编译模式,默认普通编译。不同的编译模式适用于不同的开发需求,如调试模式可能会提供更多的调试信息。
- 编译按钮:编写完小程序代码后,需要编译才能运行。默认情况下,按下 Ctrl + S 快捷键保存代码文件时,微信开发者工具会自动编译运行;若要手动编译,可单击此按钮。
- 预览按钮:单击后会生成一个二维码,使用手机微信扫描该二维码,即可在手机中预览小程序的实际运行效果,方便及时查看小程序在手机端的呈现情况,进行界面和功能的测试。
- 真机调试按钮:实现直接利用开发者工具,通过网络连接对手机上运行的小程序进行调试。这对于定位在手机上出现的问题非常有帮助,因为手机环境与模拟器环境可能存在差异,真机调试能够更准确地发现和解决实际使用中的问题。
- 清缓存按钮:用于清除数据缓存、文件缓存等。在开发过程中,缓存可能会影响小程序的运行效果,及时清除缓存可以确保获取最新的代码和数据。
- 上传按钮:将代码上传到小程序管理后台,在 “开发管理” 中可以查看上传的版本。当小程序开发完成后,需要将代码提交审核时,就通过此按钮上传代码。需要注意的是,如果创建项目时使用的 AppID 为测试号,则不会显示 “上传” 按钮。
- 版本管理按钮:用于通过 Git 对小程序进行版本管理,方便团队协作开发,记录代码的修改历史,便于回溯和管理不同版本的代码。
- 模拟器功能
- 模拟器用于模拟手机环境,可查看小程序在不同型号手机上的运行效果。在模拟器中,你可以选择不同的手机型号(如 iPhone 12/13 (Pro) 等),设置屏幕分辨率、网络环境等参数,以尽可能真实地模拟用户使用场景。同时,模拟器支持热重载功能,即在修改代码后,无需重新编译整个项目,即可实时看到修改后的效果,提高开发效率。
- 编辑器使用
- 编辑器分为左右两栏。左栏用于浏览项目目录结构,方便快速定位和打开所需文件。右栏用于编写代码,在左栏单击某个文件,右栏就会显示该文件的内容,供开发者进行编辑。例如,在开发小程序页面时,可在右栏编辑页面的逻辑文件(.js)、结构文件(.wxml)、配置文件(.json)和样式文件(.wxss)等。
- 调试器功能
- 调试器类似于 Google Chrome 浏览器中的开发者工具,提供了丰富的调试功能。
- Console(控制台)面板:用于输出调试信息,开发者可以在代码中使用 console.log () 等方法输出变量值、执行结果等信息,方便查看代码的执行流程和数据状态。同时,也可以直接在控制台编写代码执行,进行一些简单的测试和调试。
- Sources(源代码)面板:可以查看或编辑源代码,并支持代码调试。在调试过程中,可以设置断点、单步执行代码、查看变量值等,帮助开发者深入分析代码逻辑,查找和解决问题。
- Network(网络)面板:用于记录网络请求信息,包括请求的 URL、方法、参数、响应状态码、响应数据等。通过分析网络请求,开发者可以优化网络性能,如检查是否存在过多的网络请求、请求是否超时等问题。
- Security(安全)面板:用于调试页面的安全和认证等信息,如检查 HTTPS 配置是否正确、是否存在安全漏洞等,确保小程序的安全性。
- AppData(App 数据)面板:可以查看或编辑当前小程序运行时的数据,方便开发者了解数据的变化和状态,检查数据是否正确存储和更新。
- Audits(审计)面板:用于对小程序进行体验评分,根据一系列性能指标和最佳实践标准,评估小程序的质量,提供改进建议,帮助开发者提升小程序的用户体验。
- Sensor(传感器)面板:用于模拟地理位置、重力感应等传感器数据,方便开发者测试与传感器相关的功能,如地图应用中的定位功能、游戏中的重力感应操作等。
- Storage(存储)面板:用于查看和管理本地数据缓存,开发者可以查看小程序在本地存储的数据,包括缓存的数据、用户偏好设置等,确保数据存储和读取的正确性。
- Trace(跟踪)面板:用于真机调试时跟踪调试信息,记录小程序在手机上运行的详细过程,帮助开发者在真机环境下查找问题。
- Wxml(WXML 和 WXSS)面板:用于查看和调试 WXML 和 WXSS,可实时查看页面结构和样式的渲染效果,检查布局是否正确、样式是否生效等。