2.2 新建第一个项目
开发工具安装完成后,我们来新建第一个小程序项目。双击打开微信Web开发者工具,如果你是第一次打开或者长时间未打开,开发工具都会弹出一个二维码,如图2-3所示。请使用微信“扫一扫”功能扫描二维码。是的,开发工具也需要登录,而登录的身份就是你的微信号。
登录后可看到图2-4所示的开发者工具首选页面。
图2-3 扫描二维码登录开发者工具
图2-4 开发者工具首选页面
图2-5 添加项目页面
首选页面一共有2个工具,分别是【本地小程序项目】和【公众号网页开发】。【本地小程序项目】用来开发、调试、发布微信小程序;而【公众号网页开发】用来开发和调试微信公众号、订阅号的网页应用。由于小程序和公众号是两个完全不同的平台和体系,公众号的开发不在本书的讨论范围之内,我们只关注【本地小程序项目】这个工具,有兴趣的读者可以自行去研究学习“公众号网页开发”工具。点击【本地小程序项目】,将出现如图2-5所示的页面。
页面中需要填入的选项有【AppID】、【项目名称】、【项目目录】这3个选项,我们重点看【AppID】这一项。
AppID代表微信小程序的ID号,必须拥有微信小程序账号才可以申请这个ID号。读者可以到微信公众平台官网注册申请微信小程序账号,注册地址为:https://mp.weixin.qq.com/。
遗憾的是截止本书完稿时,小程序账号并不对个人开发者开放,只对企业、政府和组织开放。没有AppID将无法在真机上运行小程序,但并不影响我们学习小程序开发,小程序开发工具提供了一个很好的模拟器,可以在PC或者Mac下模拟小程序的运行。本书中的绝大多数功能都可以在PC或者Mac下运行,少部分无法在模拟器下运行的功能,本书也会使用图片的方式向读者展示运行效果,不用担心没有AppID无法真机运行小程序的问题。
既然没有AppID,那么我们就选择【无AppID】这个选项。【无AppID】主要用于方便开发者学习和调试。相比于有AppID,无AppID模式的运行环境非常宽松,例如,无AppID环境下无须配置可信任访问域名、不会校验TLS版本等(这些特点将在本书的后面具体来讲解,读者现在无须搞懂这些内容)。现在,我们只需要选择【无AppID】即可。
按照以下步骤创建第一个小程序项目。
在【AppID】选项选择【无AppID】。
填入一个项目名称,如HelloLittleApple。建议使用英文,中文可能会引起一些未知错误。
选择一个空的文件夹用于存放小程序项目文件(注意,一定要选择一个没有任何文件的空白文件夹,最好是能够新建一个文件夹)。
完成以上3步后,页面下方将出现一个【在当前目录中创建quick start项目】的复选框。如果没有这个复选框,绝大多数原因是因为在上面的第三步里,你选择的文件目录不是一个空文件夹,请重新选择一个空白文件夹。
小程序没有显著区分“新建一个项目”和“打开一个已存在的项目”。如果你选择的目录是一个空的文件夹,则小程序会认为你是想“新建项目”;而如果你选择的文件目录不是空文件夹,则小程序会认为你是要“打开一个已存在的项目”而不是要“新建一个项目”。所以,如果你想打开一个已存在的小程序项目,那么直接选择这个项目的文件路径即可。
按照上述3步完成设置后,点击右下角的【添加项目】,将成功创建一个官方提供的示例项目。