itmuch-miniapp

本项目是 IT牧场 小程序的前端代码。

本仓库用于慕课网《Spring Cloud Alibaba从入门到进阶》课程的教学。

对于前端基础不好的童鞋，可以直接放弃折腾，不会影响Spring Cloud Alibaba的学习。

该前端代码的主要作用是帮助大家感受小程序开发是个怎么回事，另外帮助大家快速理解视频中的业务。

技术选型 & 鸣谢

• mpvue
• vant-weapp

预览 & 体验

扫描如下小程序码即可。

首页	个人中心	投稿	扫我体验

使用说明

1. 安装Node.js

笔者使用的版本是 v8.15.0 ，建议和笔者保持一致。

• 前往 https://nodejs.org/en/download/ 下载Node.js。建议使用 https://nodejs.org/dist/v8.15.0/ 下载 v8.15.0 。
• 安装说明
  • Windows操作系统，参考： https://jingyan.baidu.com/article/48206aea9bd880216ad6b305.html 安装Node.js
  • CentOS操作系统，参考： https://www.cnblogs.com/baby123/p/6955396.html 安装
  • macOS操作系统，用pkg直接拖动安装即可
  • 其他系统，百度 nodejs {操作系统名称} 安装 。

2. 下载本仓库代码

可使用Git下载，也可以直接下载本仓库压缩包，二选一即可。

方式一、使用Git下载代码

git clone https://github.com/eacdy/itmuch-miniapp.git

方式二、用浏览器直接访问如下地址，下载代码

https://github.com/eacdy/itmuch-miniapp/archive/master.zip

3. 修改app信息

修改 project.config.json ，按需修改如下两行

"appid": "修改为你的appid", // 这里提供一个给大家测试：wx5398457df5368458
"projectname": "修改为你的项目名称，尽量用英文",

其中，appid在 微信公众平台 - 开发 - 开发设置中可以找到。

4. 安装 & 启动前端代码

# 安装项目相关依赖
npm install
# 加速：
npm --registry https://registry.npm.taobao.org install

# 开发环境启动部署
npm run dev

# 生产环境构建
npm run build

# 其他，可参考：http://mpvue.com/build/

5. 下载 & 安装微信开发者工具

• 前往 https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html 下载开发者工具。
• 安装开发者工具

6. 修改调用API地址

找到src/utils/api.js ，找到

// 后端接口基础路径
export const BASE_API_URL = '';

将其修改为你的后端地址，例如：

export const BASE_API_URL = 'http://localhost:8080';

7. 将代码导入到开发者工具

注意：务必勾选 不校验合法域名... 。

可以预览啦！

8. 你可能会遇到的问题

8.1 Windows操作系统执行npm install时，报如下异常：

Error: Can't find Python executable "python", you can set the PYTHON env variable

用管理员权限执行如下命令即可：

npm install --global --production windows-build-tools

如果还是不行，那只能参考node-gyp官方的描述去尝试了：https://github.com/nodejs/node-gyp#configuring-python-dependency 。你得手动安装Python，然后执行一下：

npm config set python /path/to/executable/python

8.2 node-sass下载报404

修改package.json中引用的node-sass的版本即可。node-sass的版本可以在这里查看：https://github.com/sass/node-sass/releases

8.3 node-sass死活下载不下来(非404)

默认情况下，node-sass是从GitHub上下载二进制文件的，而GitHub把二进制文件存储在了AWS S3中。国内访问S3很不稳定。因此，也造成了node-sass安装上的困扰。

可参考 https://segmentfault.com/a/1190000010984731 的说明，里面总结了四种方式，总有一种方式能够解决。