微信小程序--优购商城项目（1）

---

前言

基于 uni-app 开发的微信小程序商城项目

• 备用接口地址：https://api-hmugo-web.itheima.net

---

一、配置uni-app开发环境

1、开发工具–HBuilderX

1. 下载HBuilderX
   HBuilderX 的官网首页 https://www.dcloud.io/hbuilderx.html

2. 安装 scss/sass 编译
   为了方便编写样式（例如：<style lang=“scss”></style>），建议安装 scss/sass 编译 插件。插件下载地址：
   https://ext.dcloud.net.cn/plugin?name=compile-node-sass

2、新建uni-app项目

目录结构：

┌─components            uni-app组件目录
│  └─comp-a.vue         可复用的a组件
├─pages                 业务页面文件存放的目录
│  ├─index
│  │  └─index.vue       index页面
│  └─list
│     └─list.vue        list页面
├─static                存放应用引用静态资源（如图片、视频等）的目录，注意：静态资源只能存放于此
├─main.js               Vue初始化入口文件
├─App.vue               应用配置，用来配置小程序的全局样式、生命周期函数等
├─manifest.json         配置应用名称、appid、logo、版本等打包信息
└─pages.json            配置页面路径、页面窗口样式、tabBar、navigationBar 等页面类信息

3、把项目运行到微信开发者工具

1. 在manifest.json 中填写小程序的AppID
   
2. 配置微信开发者工具的安装路径
   
3. 在微信开发者工具中，通过 设置 -> 安全设置 面板，开启“微信开发者工具”的服务端口：
   

4、使用Git管理

1. 在项目根目录中新建 .gitignore 忽略文件，并配置如下：

# 忽略 node_modules 目录
/node_modules
/unpackage/dist

注意：由于我们忽略了 unpackage 目录中仅有的 dist 目录，因此默认情况下，unpackage 目录不会被 Git 追踪

此时，为了让 Git 能够正常追踪 unpackage 目录，按照惯例，我们可以在 unpackage 目录下创建一个叫做 .gitkeep 的文件进行占位

2. 本地管理

git init 
git add .
git commit -m "初始化项目"

3. 托管到码云（gitee）

二、tarBar

1、创建 tabBar 分支

运行如下的命令，基于 master 分支在本地创建 tabBar 子分支，用来开发和 tabBar 相关的功能：

git checkout -b tabbar

git branch 

2、创建 tabBar 页面

在 pages 目录中，创建首页(home)、分类(cate)、购物车(cart)、我的(my) 这 4 个 tabBar 页面。在 HBuilderX 中，可以通过如下的两个步骤，快速新建页面：

• 在 pages 目录上鼠标右键，选择新建页面

• 在弹出的窗口中，填写页面的名称、勾选 scss 模板之后，点击创建按钮。截图如下：

3、配置 tabBar 效果

1. 修改项目根目录中的 pages.json 配置文件，新增 tabBar 的配置节点如下:

{
  "tabBar": {
    "selectedColor": "#C00000",
    "list": [
      {
        "pagePath": "pages/home/home",
        "text": "首页",
        "iconPath": "static/tab_icons/home.png",
        "selectedIconPath": "static/tab_icons/home-active.png"
      },
      {
        "pagePath": "pages/cate/cate",
        "text": "分类",
        "iconPath": "static/tab_icons/cate.png",
        "selectedIconPath": "static/tab_icons/cate-active.png"
      },
      {
        "pagePath": "pages/cart/cart",
        "text": "购物车",
        "iconPath": "static/tab_icons/cart.png",
        "selectedIconPath": "static/tab_icons/cart-active.png"
      },
      {
        "pagePath": "pages/my/my",
        "text": "我的",
        "iconPath": "static/tab_icons/my.png",
        "selectedIconPath": "static/tab_icons/my-active.png"
      }
    ]
  }
}

4、删除默认的 index 首页

1. 在 HBuilderX 中，把 pages 目录下的 index首页文件夹 删除掉

2. 同时，把 page.json 中记录的 index 首页 路径删除掉

3. 为了防止小程序运行失败，在微信开发者工具中，手动删除 pages 目录下的 index 首页文件夹

4. 同时，把 components 目录下的 uni-link 组件文件夹 删除掉

5、修改导航条的样式效果

1.打开 pages.json 这个全局的配置文件

2.修改 globalStyle 节点如下：

{
  "globalStyle": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "优购商城",
    "navigationBarBackgroundColor": "#C00000",
    "backgroundColor": "#FFFFFF"
  }
}

6、分支的提交与合并

1. 将本地的 tabbar 分支进行本地的 commit 提交：

git add .
git commit -m "完成了 tabBar 的开发"

2. 将本地的 tabbar 分支推送到远程仓库进行保存：

git push -u origin tabbar

3. 将本地的 tabbar 分支合并到本地的 master 分支：

git checkout master
git merge tabbar

4. 删除本地的 tabbar 分支：

git branch -d tabbar