Android Intune SDK报错：Attempt to access uninitialized OfflineComponents求助

问题描述 #

应用通过MS MSIL库实现用户登录后，按照微软官方指南使用MAM SDK 10.0.0获取应用配置，代码如下：

val configManager = MAMComponents.get(MAMAppConfigManager::class.java)
val appConfig = configManager!!.getAppConfig(identity)

运行时触发致命错误：

Fatal Exception: java.lang.AssertionError: Attempt to access uninitialized OfflineComponents
       at com.microsoft.intune.mam.client.app.offline.OfflineComponents$UninitializedContextProvider.get(OfflineComponents.java:379)
       at com.microsoft.intune.mam.client.app.offline.OfflineComponents.get(OfflineComponents.java:282)
       at com.microsoft.intune.mam.client.app.MAMComponents.get(MAMComponents.java:639)

发现未在官方文档中提及的MAMComponents.initialize(appContext)API可解决该问题，寻求相关开发者经验。

解决方案与经验分享 #

• 必须提前初始化MAMComponents：虽然该API未在10.0.0版本的官方文档中明确标注，但实际使用中，调用MAMComponents.get()获取任何组件前，必须先调用MAMComponents.initialize(appContext)完成初始化，建议在应用启动阶段（如Application的onCreate方法中）执行，确保全局上下文加载完成。
• 初始化时机注意事项：初始化需传入有效的Application Context，不能用Activity Context，避免内存泄漏；同时要在登录流程开始前或获取配置前完成初始化，不要延迟到调用getAppConfig时才执行。
• 版本兼容性验证：在MAM SDK 10.x系列版本中，这个未公开的初始化API是运行必需的前置步骤，后续版本可能会将其纳入官方文档或调整为自动初始化，但10.0.0版本必须手动调用。
• 错误根源：报错中的OfflineComponents是MAM SDK内部依赖的离线组件模块，未初始化时无法提供实例，导致MAMComponents.get()调用失败，而initialize方法正是负责完成包括OfflineComponents在内的所有核心组件的上下文绑定与初始化工作。

内容的提问来源于stack exchange，提问作者NickF