uni-halo/.agents/skills/uni-app/references/config-manifest.md

name, description

name	description
Manifest.json Configuration	App configuration, permissions, and platform-specific settings

Manifest.json Configuration

manifest.json is the application configuration file, defining app name, icon, permissions, and platform-specific settings.

Basic Configuration

{
  "name": "My App",
  "appid": "__UNI__XXXXXXX",
  "description": "App description",
  "versionName": "1.0.0",
  "versionCode": 100,
  "locale": "auto",
  "debug": false
}

Basic Properties

Property	Type	Description
name	String	App name
appid	String	DCloud app ID
description	String	App description
versionName	String	Version name (1.0.0)
versionCode	Number	Version code (integer)
locale	String	Default language
debug	Boolean	Debug mode
networkTimeout	Object	Network timeout settings
uniStatistics	Object	Statistics configuration

Network Timeout

{
  "networkTimeout": {
    "request": 60000,
    "connectSocket": 60000,
    "uploadFile": 60000,
    "downloadFile": 60000
  }
}

App Configuration (app-plus)

{
  "app-plus": {
    "splashscreen": {
      "alwaysShowBeforeRender": true,
      "autoclose": true,
      "waiting": true
    },
    "screenOrientation": ["portrait-primary"],
    "modules": {
      "OAuth": {},
      "Payment": {},
      "Push": {}
    },
    "distribute": {
      "android": {
        "permissions": [
          "<uses-permission android:name=\"android.permission.INTERNET\" />"
        ],
        "minSdkVersion": 21,
        "targetSdkVersion": 30
      },
      "ios": {
        "capabilities": {
          "entitlements": {
            "com.apple.developer.push": true
          }
        }
      },
      "sdkConfigs": {
        "payment": {
          "alipay": {},
          "weixin": {}
        }
      }
    },
    "optimization": {
      "subPackages": true
    }
  }
}

Splash Screen

Property	Type	Description
alwaysShowBeforeRender	Boolean	Show until first page renders
autoclose	Boolean	Auto close splash screen
waiting	Boolean	Show loading indicator

Mini-Program Configuration

WeChat (mp-weixin)

{
  "mp-weixin": {
    "appid": "wx1234567890",
    "setting": {
      "urlCheck": false,
      "es6": true,
      "postcss": true,
      "minified": true
    },
    "usingComponents": true,
    "permission": {
      "scope.userLocation": {
        "desc": "Your location is needed"
      }
    },
    "requiredPrivateInfos": [
      "getLocation"
    ]
  }
}

Alipay (mp-alipay)

{
  "mp-alipay": {
    "appid": "2021...",
    "allowsAlignRight": true,
    "component2": true
  }
}

Baidu (mp-baidu)

{
  "mp-baidu": {
    "appid": "12345678",
    "navigationBarForceEnable": true
  }
}

Douyin (mp-toutiao)

{
  "mp-toutiao": {
    "appid": "tt...",
    "setting": {
      "es6": true,
      "minified": true
    }
  }
}

H5 Configuration

{
  "h5": {
    "title": "My App",
    "template": "index.html",
    "router": {
      "mode": "hash",
      "base": "./"
    },
    "optimization": {
      "treeShaking": {
        "enable": true
      }
    },
    "publicPath": "./",
    "devServer": {
      "port": 8080,
      "disableHostCheck": true
    },
    "sdkConfigs": {
      "maps": {
        "qqmap": {
          "key": "..."
        }
      }
    }
  }
}

Vue Configuration

Vue 2

{
  "vueVersion": "2",
  "sassImplementationName": "dart-sass"
}

Vue 3

{
  "vueVersion": "3"
}

Permission Configuration

Android Permissions

{
  "app-plus": {
    "distribute": {
      "android": {
        "permissions": [
          "<uses-permission android:name=\"android.permission.INTERNET\" />",
          "<uses-permission android:name=\"android.permission.CAMERA\" />",
          "<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\" />",
          "<uses-permission android:name=\"android.permission.READ_EXTERNAL_STORAGE\" />",
          "<uses-permission android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\" />"
        ]
      }
    }
  }
}

iOS Privacy Descriptions

{
  "app-plus": {
    "distribute": {
      "ios": {
        "privacyDescription": {
          "NSCameraUsageDescription": "Camera access is needed for scanning QR codes",
          "NSPhotoLibraryUsageDescription": "Photo access is needed for uploading images",
          "NSLocationWhenInUseUsageDescription": "Location is needed for finding nearby stores"
        }
      }
    }
  }
}

Common Module Configuration

OAuth (Login)

{
  "app-plus": {
    "modules": {
      "OAuth": {}
    },
    "distribute": {
      "sdkConfigs": {
        "oauth": {
          "weixin": {
            "appid": "wx...",
            "appsecret": "...",
            "UniversalLinks": "https://..."
          }
        }
      }
    }
  }
}

Payment

{
  "app-plus": {
    "modules": {
      "Payment": {}
    },
    "distribute": {
      "sdkConfigs": {
        "payment": {
          "alipay": {},
          "weixin": {
            "appid": "wx..."
          }
        }
      }
    }
  }
}

Push Notifications

{
  "app-plus": {
    "modules": {
      "Push": {}
    },
    "distribute": {
      "sdkConfigs": {
        "push": {
          "unipush": {}
        }
      }
    }
  }
}

Share

{
  "app-plus": {
    "modules": {
      "Share": {}
    },
    "distribute": {
      "sdkConfigs": {
        "share": {
          "weixin": {
            "appid": "wx..."
          }
        }
      }
    }
  }
}

Statistics Configuration

{
  "uniStatistics": {
    "enable": true
  },
  "app-plus": {
    "uniStatistics": {
      "enable": true
    }
  },
  "mp-weixin": {
    "uniStatistics": {
      "enable": true
    }
  }
}