RePlugin中实现插件横屏显示的正确配置方式

背景介绍

RePlugin作为一款强大的Android插件化框架，允许开发者将应用功能模块化并动态加载。在实际开发中，我们经常需要处理插件Activity的屏幕方向问题，特别是横屏显示的需求。

常见误区

许多开发者在尝试实现插件横屏显示时，容易陷入以下误区：

1. 仅在宿主配置中设置useOccupyLand = true，而忽略了插件本身的配置
2. 认为框架会自动处理所有屏幕方向问题
3. 不清楚横屏配置的具体位置和方式

正确配置方法

要实现插件Activity的横屏显示，需要以下两个关键步骤：

1. 宿主配置

在宿主的build.gradle文件中，确保启用了横屏支持：

repluginHostConfig {
    useAppCompat = true
    useAndroidX = true
    useOccupyLand = true // 启用横屏支持
}

2. 插件Activity配置

这才是最关键的部分，必须在插件的AndroidManifest.xml中为需要横屏显示的Activity明确指定屏幕方向：

<activity
    android:name=".YourActivity"
    android:exported="false"
    android:screenOrientation="landscape" />

这里的android:screenOrientation属性支持多种值：

• landscape：常规横屏
• reverseLandscape：反向横屏
• sensorLandscape：根据传感器自动选择横屏方向
• userLandscape：用户首选的横屏方向

注意事项

1. 优先级问题：插件Activity的screenOrientation配置会覆盖宿主配置
2. 兼容性问题：不同Android版本对横屏的支持可能略有差异
3. 布局适配：横屏布局需要单独设计，不能简单依赖系统自动旋转
4. 生命周期：屏幕方向变化会触发Activity重建，需要注意状态保存

最佳实践

1. 对于必须横屏显示的插件Activity，建议固定方向为landscape
2. 对于可横竖屏切换的Activity，可以使用sensor或fullSensor
3. 在插件开发阶段就考虑横屏布局，避免后期适配困难
4. 测试时注意不同厂商ROM对横屏的特殊处理

通过以上配置和注意事项，开发者可以轻松实现RePlugin插件中的横屏显示功能，提升用户体验。