uni-halo/.agents/bak-skills/uniapp-ucharts/examples/integration/manifest-config.md

Manifest Configuration

manifest.json 配置

manifest.json 是 UniApp 的应用配置文件，需要正确配置以支持 uCharts 在不同平台运行。

基本配置

{
  "name": "uniapp-ucharts-project",
  "appid": "",
  "description": "",
  "versionName": "1.0.0",
  "versionCode": "100",
  "transformPx": false,
  "app-plus": {
    "usingComponents": true
  },
  "h5": {
    "router": {
      "mode": "hash"
    }
  },
  "mp-weixin": {
    "appid": "",
    "setting": {
      "urlCheck": false
    },
    "usingComponents": true
  }
}

H5 平台配置

{
  "h5": {
    "router": {
      "mode": "hash",
      "base": "/"
    },
    "devServer": {
      "https": false,
      "port": 8080
    },
    "publicPath": "/",
    "template": "index.html"
  }
}

微信小程序配置

{
  "mp-weixin": {
    "appid": "your-appid",
    "setting": {
      "urlCheck": false,
      "es6": true,
      "enhance": true,
      "postcss": true,
      "minified": true
    },
    "usingComponents": true,
    "permission": {
      "scope.userLocation": {
        "desc": "你的位置信息将用于小程序位置接口的效果展示"
      }
    }
  }
}

App 平台配置

{
  "app-plus": {
    "usingComponents": true,
    "nvueStyleCompiler": "uni-app",
    "splashscreen": {
      "alwaysShowBeforeRender": true,
      "waiting": true,
      "autoclose": true,
      "delay": 0
    },
    "distribute": {
      "android": {
        "permissions": [
          "<uses-permission android:name=\"android.permission.INTERNET\"/>"
        ]
      },
      "ios": {}
    }
  }
}

完整配置示例

{
  "name": "uniapp-ucharts-project",
  "appid": "",
  "description": "UniApp + uCharts 项目",
  "versionName": "1.0.0",
  "versionCode": "100",
  "transformPx": false,
  "app-plus": {
    "usingComponents": true,
    "nvueStyleCompiler": "uni-app"
  },
  "h5": {
    "router": {
      "mode": "hash"
    },
    "devServer": {
      "port": 8080
    }
  },
  "mp-weixin": {
    "appid": "",
    "setting": {
      "urlCheck": false,
      "es6": true,
      "enhance": true,
      "postcss": true,
      "minified": true
    },
    "usingComponents": true
  }
}

关键配置说明

usingComponents

所有平台都需要设置 "usingComponents": true，以支持组件使用。

transformPx

建议设置为 false，使用 rpx 单位进行响应式布局。

Canvas 支持

uCharts 依赖 Canvas，确保目标平台支持 Canvas：

• H5：完全支持 Canvas
• 小程序：支持 Canvas，但可能有性能限制
• App：支持 Canvas，但 nvue 可能有限制

注意事项

1. usingComponents：必须设置为 true
2. 平台差异：不同平台对 Canvas 的支持可能有差异
3. AppID：小程序平台需要配置对应的 AppID
4. 权限配置：根据功能需求配置相应权限
5. 版本号：正确配置版本号和版本名称
6. Canvas 兼容性：注意不同平台的 Canvas 兼容性