用途:帮助开发者在 Kuikly 中管理并加载本地 assets 资源,包括目录结构规范、各平台打包配置和 ImageUri API 使用。
资源目录结构:assets 资源放在 shared/src/commonMain/assets 下,推荐按页面建目录(如 MyPage/),多页面共享资源放 common/ 目录。
ImageUri API:统一资源 URI 封装类,用于 Image、PAG 等组件。常用工厂方法包括 ImageUri.pageAssets("banner.png")(页面资源,生成 assets://#pageName#/banner.png,运行时替换页面名)、ImageUri.pageAssets("icons/star.png")(页面子目录)、ImageUri.commonAssets("logo.png")(公共资源,生成 assets://common/logo.png)、ImageUri.file("/path/to/image.png")(本地文件)。URI Scheme 常量有 SCHEME_COMMON_ASSETS、SCHEME_PAGE_ASSETS、SCHEME_FILE、SCHEME_BASE64。
加载方式:Kuikly DSL 中在 Image 组件 attr 内用 src(ImageUri.pageAssets(...)) 或 src(ImageUri.commonAssets(...))。Compose DSL 通过 DrawableResource + ImageUri 加载,目录结构与打包配置一致;需 @OptIn(InternalResourceApi::class) 定义 DrawableResource,再用 painterResource 返回 Painter 供 Image 使用,或用 imageResource 返回 ImageBitmap 供 Canvas 绘制。
平台打包:首次使用 assets 需配置打包,涉及 Android、iOS、鸿蒙、H5、微信小程序、动态化等平台,具体见 PLATFORM_CONFIG.md。
限制:资料未提供各平台打包配置的具体步骤、价格、平台支持范围等细节,暂未提供。