uni-halo/.agents/bak-skills/uniappx-uview-pro/api/config-api.md

Configuration API | 配置 API

Instructions

This example provides configuration API reference for UniAppX projects with uView Pro.

Key Concepts

• Project configuration
• Build configuration
• Platform configuration
• Component configuration

Project Configuration

// project.config.json (if exists)
{
  "miniprogramRoot": "string",
  "projectname": "string",
  "description": "string",
  "appid": "string"
}

Build Configuration

// manifest.json - Build settings
{
  "h5": {
    "devServer": {
      "port": number,
      "disableHostCheck": boolean
    },
    "router": {
      "mode": "hash" | "history",
      "base": "string"
    },
    "optimization": {
      "treeShaking": {
        "enable": boolean
      }
    }
  },
  "mp-weixin": {
    "setting": {
      "es6": boolean,
      "enhance": boolean,
      "postcss": boolean,
      "minified": boolean
    }
  }
}

Platform Configuration

// manifest.json - Platform settings
{
  "h5": {
    "router": {
      "mode": "hash" | "history"
    }
  },
  "mp-weixin": {
    "appid": "string",
    "setting": {
      "urlCheck": boolean
    }
  },
  "app-plus": {
    "distribute": {
      "android": {
        "permissions": ["string"]
      },
      "ios": {}
    }
  }
}

Component Configuration

<!-- Component usage with configuration -->
<template>
  <u-button 
    type="primary"
    :custom-style="buttonStyle"
    :disabled="isDisabled"
  >
    按钮
  </u-button>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const buttonStyle = ref({
  borderRadius: '20rpx'
})
const isDisabled = ref(false)
</script>

Key Points

• Configure project settings in manifest.json
• Set up build options for each platform
• Configure platform-specific settings
• Use component props for configuration
• Test configuration on all platforms