fix(custom): scope

This commit is contained in:
lukaijie
2025-11-18 17:12:34 +08:00
parent ffee2cade2
commit 052e286e34

133
README.md
View File

@@ -1,69 +1,80 @@
# 说明文档
## .env文件配置信息
```json
{
"APP_BASE_URL": "接口访问地址",
"APP_WEBSOCKET": "websocket访问地址",
"APP_COMPANY_ID": "企业id",
"APP_PLATFORM": "打包平台standard为标准版, platform为平台版",
"APP_CUSTOM_SERVER": "域名地址H5支付回调使用",
"APP_HOME_PAGE": "首页访问路径",
"APP_MAP_KEY": "H5 腾讯地图使用key",
"APP_MAP_NAME": "H5 使用地图name"
}
<p align="center"><img width="500" height="auto" alt="logo1" src="https://github.com/user-attachments/assets/097cbde6-cedd-42d0-a2d8-a0a0430289b5" /></p>
### <p align="center">Mobile Frontend</p>
# Getting started
Node.js (current LTS) and npm are required to run the project. To be sure about the version compatibility you can enable Node's corepack.
### System Requirements
Required Node.js Version: 16.16.0. If your current version differs, follow the steps below to switch
```
nvm install 16.16.0
nvm use 16.16.0
```
## npm打包指令
```bash
#小程序本地开发编译
npm run dev:weapp
#小程序生产打包
npm run build:weapp
### Installation
```
cd ecshopx-vshop
npm i
```
### Configure the .env file
```shell
# Backend API Base URL
APP_BASE_URL=
# WebSocket Endpoint
APP_WEBSOCKET=
#H5本地开发编译
# System Tenant ID
APP_COMPANY_ID=1
# System Business Model (b2c/bbc)
APP_PLATFORM=b2c
# Mobile Web App Payment Callback Domainused for payment result notifications.
APP_CUSTOM_SERVER=
# App Homepage Path
APP_HOME_PAGE=/pages/index
# WeChat Mini Program AppIDrequired for compiling the mini program
APP_ID=wx1e25e45145b70faa
# Map Service API Key, used for geocoding user LBS coordinates and providing location-based offline store recommendations.
APP_MAP_KEY=
# Mapping Service Provider Name
APP_MAP_NAME=
# Media files OSS Server URL
APP_IMAGE_CDN=
# Store Operations Tool Domain Address
APP_DIANWU_URL=
# Merchant Portal Domain Address
APP_MERCHANT_URL=
# Payment Callback URL for Third-Party Payment Platforms
APP_ADAPAY=
```
### Run project
```shell
# Compile Mobile Web App
npm run dev:h5
```
```shell
# Compile WeChat Mini Program
npm run dev:weapp
```
#H5生产打包
### Build packages
```shell
# Compile Mobile Web App
npm run build:h5
```
## 注意事项
- 关于小程序预览dev:weapp本地开发编译模式下因为主包过大无法上传预览需要使用build:weapp打包后选择小程序开发工具中的详情->本地设置->上传代码时自动压缩混淆
## shell脚本指令使用
- dev.sh和run.sh脚本命令使用,conpanys.conf文件为设置env.json文件的配置信息新增配置需同已有配置格式保持一致,打包完成后需手动更改appid
```bash
#开发模式使用
sh dev.sh
#打包使用
sh run.sh
```shell
# Compile WeChat Mini Program
npm run build:weapp
```
cicd test 3
## 代码prettier
npm run prepare
npx husky add .husky/pre-commit "npx lint-staged --allow-empty"
## 如果用ASW打包上传cdn需要增加以下配置,配置值根据实际情况调整
APP_PUBLIC_PATH=https://CDN域名
APP_CDN=aws
APP_CDN_PATH=ecshopx-vshop/
APP_CDN_KEY=
APP_CDN_SCERET=
APP_CDN_REGION=ap-southeast-2
APP_CDN_BUCKET=unat-bucket
# 如遇初始化下载时间过长或者network timeout可更换npm镜像源
# npm更换淘宝镜像使用此命令后npm指令关键词改为cnpm例如npm i 改为 cnpm i
# 更换命令npm install -g cnpm --registry=https://registry.npm.taobao.org
# 先安装插件
# 再安装其他依赖
npm install