Skip to content

iqszlong/wx-project

Repository files navigation

wx-project

Taro 小程序项目模板。使用京东Nutui搭建的商城小程序模板。 基于Taro的开箱即用微信小程序开发包。

使用库

包含功能

  • 微信授权登录
  • 购物车
  • 订单
  • 收货地址
  • 支付
  • 分享
  • 修改用户资料
  • 路由权限
  • 商品分类列表
  • 商品详情
  • 地图定位
  • 微信通知

项目目录

  • components (组件)
    • @lazy/components-wx (Lazy微信组件包)
  • packages (项目文件)
    • nutui (可以作为项目模板复制使用)
  • utils (工具js)
    • /js (公共js) @lazy/utils
    • /wx (微信小程序公共js) @lazy/utils-wx

Nutui模板目录

  • config (配置文件)

  • dist (生成文件)

Nutui模板使用前事项

  • 修改project.config.json文件中的appid为小程序的AppID,或新建project.private.config.json添加appid为小程序的AppID
  • config/prod.js需修改env.API为线上请求地址。开发则修改config/dev.js中的env.API为开发请求地址。
  • 发布微信前,需要pnpm build:weapp打包一次线上版本。

Nutui模板运行以及打包路径

网页端:dist/h5

微信小程序:dist/weapp

安装

进入项目目录packages/nutui运行命令

# 安装依赖
pnpm i
# 启动项目
pnpm dev:weapp-win #windows
pnpm dev:weapp-mac #Mac

# 打包微信小程序
pnpm build:weapp

Taro版本同步

遇到编译打包失败,或者版本升级,可以使用以下命令同步Taro版本。

# 使用Taro 升级命令更新CLI版本到最新版本
pnpm taro update self
# 使用Taro 升级命令更新CLI版本到指定版本
pnpm taro update self [版本号]
# 使用Taro 升级命令将项目依赖升级到与@tarojs/cli一致的版本
pnpm taro update project
# 使用Taro 升级命令将项目依赖升级到指定版本
pnpm taro update project [版本号]

微信小程序分包优化

官方分包示例 github示例

app.config.js中添加subpackages配置,示例如下

pages: [
    "pages/index/index",
    "pages/category/index",
    "pages/find/index",
    "pages/cart/index",
    "pages/my/index",

    "pages/login/index",
    "pages/notfind/index",
  ],
  subpackages: [
    {
      root: "shop",
      name: "shop",
      pages: [
        "pages/market/index",
        "pages/market/detail",
        "pages/order/index",
        "pages/order/result",
        "pages/order/order",
        "pages/order/detail",
      ],
    },
    {
      root: "settings",
      name: "settings",
      pages:[
        "pages/index/index",
        "pages/user/baseInfo",
        "pages/address/index",
        "pages/address/add",
        "pages/address/edit",

      ]
    }
  ],

分包后页面的路径也发生变化,shop分包页面的访问路径是/shop/pages/order/ordersettings分包页面访问路径是/setting/pages/index/index。分包后主包内容会减少,但根据Taro文档的说法文件总量会增加。

注意:分包页面不能使用在底部导航栏tabBar中,只能用主包pages中的页面

问题解决方案收集

相关文档

About

Taro小程序启动外壳

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published