Kuikly 网络请求

Contents

• Core Guidelines
• Workflow: HTTP Requests
• Workflow: Binary Requests
• Workflow: Parsing JSON
• 参考资源

Core Guidelines

• 获取 NetworkModule：
  • Kuikly DSL（Pager / ComposeView）： 直接调用 acquireModule<NetworkModule>(NetworkModule.MODULE_NAME) 获取（找不到时抛异常），或用 getModule<NetworkModule>(NetworkModule.MODULE_NAME) 安全获取（找不到返回 null）。推荐 lazy 缓存实例。
  • Compose DSL（@Composable 函数中）： 通过 LocalActivity.current.getPager() 获取 Pager 实例，再调用 pager.acquireModule<NetworkModule>(NetworkModule.MODULE_NAME)。在 ComposeContainer 类内部（非 @Composable 上下文）可直接调用 acquireModule。
• 检查 success： 回调中先判断 success，为 true 时才安全使用 data。失败时通过 errorMsg 和 response.statusCode（注意：Int? 可空）排查。
• 设置超时： httpRequest / httpRequestBinary 可指定 timeout（秒），默认 30。
• 非 JSON 回包： SDK 自动包装为 {"data": "原始内容"}，通过 data.optString("data") 获取。