环境要求

pangrowth_content 2.0 只提供 PanGrowth 短剧能力，并依赖 gromore_ads 完成广告变现。

添加依赖

dependencies:
  gromore_ads: ^2.0.0
  pangrowth_content: ^2.0.0

flutter pub get

发布工程不得使用本地 path: 或 git 依赖。

Android

在宿主工程的仓库配置中加入穿山甲 Maven 仓库：

repositories {
  google()
  mavenCentral()
  maven(url = "https://artifact.bytedance.com/repository/Volcengine")
  maven(url = "https://artifact.bytedance.com/repository/pangle")
}

应用只打包 arm64-v8a：

android {
  defaultConfig {
    minSdk = 24
    ndk {
      abiFilters += "arm64-v8a"
    }
  }
}

聚合页、滑滑流和播放器使用 Android Fragment，宿主入口必须是 FlutterFragmentActivity：

import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity : FlutterFragmentActivity()

插件会对这三个 PlatformView 强制使用 Hybrid Composition，并在容器 attached 后才提交 Fragment。使用 FlutterActivity 时页面会明确创建失败。

插件使用 pangrowth-base:2.8.0.2 与 pangrowth-djx-sdk-lite:2.8.0.2，配套 gromore_ads 固定使用 Android GroMore 7.6.4.3。SDK 所需 Provider 由依赖自身合并到应用清单。

固定的 Android 2.8.0.2 AAR 尚未导出新文档中的三个折叠屏 Builder 方法。foldDeviceFromHost、useSdkInternalFoldDetection 和 enableFoldableScreenAdaptation 必须保持未设置；显式设置会抛出 UNSUPPORTED_SDK_CONFIG，不会被静默忽略。

iOS

Podfile 需要同时声明 CocoaPods 与 Volcengine Specs：

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/volcengine/volcengine-specs.git'

platform :ios, '13.0'

插件使用 PangrowthX/shortplay 2.9.0.5，广告依赖由 gromore_ads 的 Ads-CN/CSJMediation 7.6.1.8 统一提供。

cd ios
pod install

短剧配置文件

从穿山甲赋能平台下载与真实 Android 包名、iOS Bundle ID 和签名身份匹配的 SDK_Setting_*.json。将文件作为 Flutter asset 或原生 Bundle 资源加入应用，并把路径传给 PangrowthInitConfig。

配置文件不是长期静态模板。应用身份、授权能力或 SDK 版本变化后，应重新从平台下载并替换。

appId、广告位和 SDK_Setting_*.json 是会随客户端产物分发的宿主配置，是否纳入版本控制由宿主仓库策略决定，但不得输出到日志。配置必须由宿主专用文件提供，缺失或必填值为空时必须在 SDK 初始化前明确失败。服务端签名参数与解锁记录 server key 只能保存在业务服务端，应用签名私钥也不得进入客户端配置或源码。

插件发布包不携带独立 example。仓库维护者只使用集中集成应用 projects/light_csj 进行广告与短剧真机验证。其 Android application ID 为已登记的 com.tjliujia.doukuai，签名使用 projects/shortplay/flutter 所管理 keystore 中的 doukuai alias，并配套 GroMore App ID 5609594 与 SDK_Setting_5609594.json；iOS 继续使用现有登记身份和签名配置。仓库工程不是 pub 用户的运行依赖，接入方应使用自己的平台注册信息和本地配置。

初始化顺序

必须在用户同意隐私协议后先启动 GroMore，再保存并启动 PanGrowth 配置。PanGrowth 的 start() 成功前不得创建聚合页、滑滑流、卡片或播放器。

下一步参见快速开始。