Android自由窗口开发指南：从原理到实践

1. Android自由窗口技术背景与演进

在Android 12L（API level 32）之前，多窗口功能一直处于半开放状态。直到Android U（API level 34）的发布，自由窗口（Freeform Window）才真正成为系统级的标准特性。与传统分屏模式不同，自由窗口允许应用以可调整大小的浮动窗口形式运行，这彻底改变了移动设备的多任务交互方式。

自由窗口的核心实现基于WindowManagerService的改造。系统为每个自由窗口创建独立的WindowToken，并通过WindowContainer层级结构管理窗口位置和堆叠顺序。在底层，SurfaceFlinger负责将这些窗口内容合成到显示设备上。

注意：自由窗口与传统的Dialog或PopupWindow有本质区别。前者是完整的Activity实例，拥有独立生命周期；后者只是依附于宿主Activity的视图组件。

2. 自由窗口的三种实现路径

2.1 系统级自由窗口（API 34+）

从Android U开始，开发者可以通过以下代码启用自由窗口模式：

kotlin复制// 在AndroidManifest.xml中声明
<activity 
    android:name=".MyActivity"
    android:resizeableActivity="true"
    android:supportsPictureInPicture="true"
    android:windowLayoutAffinity="freeform" />

// 动态设置窗口参数
window.attributes = window.attributes.apply {
    width = 800.dpToPx()
    height = 600.dpToPx()
    gravity = Gravity.START or Gravity.TOP
    windowAnimations = R.style.FreeformAnimation
}

关键参数说明：

• resizeableActivity：允许Activity调整大小
• windowLayoutAffinity：指定窗口亲和性为自由模式
• dpToPx()：需要自定义的DP到像素转换扩展函数

2.2 兼容模式自由窗口（API 26-33）

对于需要向下兼容的情况，可以使用以下反射方案：

kotlin复制fun enableFreeform(activity: Activity) {
    try {
        val options = ActivityOptions.makeBasic()
        val setLaunchBounds = options.javaClass.getMethod(
            "setLaunchBounds", 
            Rect::class.java
        )
        setLaunchBounds.invoke(options, Rect(100, 100, 900, 700))
        
        val startActivity = Activity::class.java.getMethod(
            "startActivity", 
            Intent::class.java, 
            Bundle::class.java
        )
        startActivity.invoke(activity, intent, options.toBundle())
    } catch (e: Exception) {
        Log.e("Freeform", "Compatibility mode failed", e)
    }
}

2.3 第三方浮窗方案

当系统不支持时，可以考虑基于WindowManager的实现：

kotlin复制class FloatingWindow(context: Context) {
    private val windowManager = context.getSystemService(Context.WINDOW_SERVICE) as WindowManager
    private val layoutParams = WindowManager.LayoutParams(
        WindowManager.LayoutParams.WRAP_CONTENT,
        WindowManager.LayoutParams.WRAP_CONTENT,
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) 
            WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY
        else 
            WindowManager.LayoutParams.TYPE_PHONE,
        WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
        PixelFormat.TRANSLUCENT
    ).apply {
        gravity = Gravity.START or Gravity.TOP
        x = 100
        y = 100
    }

    fun show(view: View) {
        windowManager.addView(view, layoutParams)
    }
}

3. 自由窗口的交互设计要点

3.1 窗口控制三要素

1. 拖拽手柄：应在窗口顶部保留至少48dp高的拖拽区域
2. 边框调节：窗口四边和四角应支持8dp以上的触控区域
3. 操作按钮：最小化/最大化/关闭按钮需要符合Material Design规范

3.2 尺寸约束策略

kotlin复制// 在Activity中设置最小尺寸
override fun onAttachedToWindow() {
    window.setMinimumWidth(300.dpToPx())
    window.setMinimumHeight(200.dpToPx())
    
    // 横竖屏不同约束
    if (resources.configuration.orientation == ORIENTATION_LANDSCAPE) {
        window.setMaximumWidth(resources.displayMetrics.widthPixels)
        window.setMaximumHeight((resources.displayMetrics.heightPixels * 0.8f).toInt())
    } else {
        window.setMaximumWidth((resources.displayMetrics.widthPixels * 0.9f).toInt())
        window.setMaximumHeight((resources.displayMetrics.heightPixels * 0.6f).toInt())
    }
}

3.3 多窗口协同工作

实现窗口间通信的三种方式：

1. Intent传递：适合一次性数据传递
2. ViewModel共享：通过Activity的ViewModelProvider
3. ContentProvider：适合大量数据共享

4. 自由窗口的常见问题排查

4.1 窗口位置异常

典型表现：窗口显示在屏幕外或位置随机变化

排查步骤：

1. 检查LayoutParams的gravity设置
2. 验证x/y坐标是否超出屏幕范围
3. 确认没有与其他窗口的affinity冲突

4.2 输入焦点丢失

解决方案：

xml复制<!-- 在style.xml中定义 -->
<style name="FreeformWindowTheme" parent="Theme.Material3.DayNight">
    <item name="android:windowIsFloating">true</item>
    <item name="android:windowCloseOnTouchOutside">false</item>
    <item name="android:windowSoftInputMode">adjustResize</item>
</style>

4.3 生命周期异常

自由窗口Activity的特殊生命周期：

1. 窗口最小化时：onPause()但不会onStop()
2. 窗口恢复时：直接onResume()
3. 窗口关闭时：正常执行onDestroy()

5. 性能优化实践

5.1 内存管理策略

kotlin复制override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)
    // 自由窗口尺寸变化时释放非必要资源
    if (newConfig.screenWidthDp != lastWidth || 
        newConfig.screenHeightDp != lastHeight) {
        releaseBackgroundResources()
    }
}

5.2 渲染性能优化

1. 使用硬件层加速：

xml复制<ImageView
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layerType="hardware" />

2. 限制过度绘制：

kotlin复制window.setBackgroundDrawable(
    ColorDrawable(Color.TRANSPARENT)
)

5.3 跨版本兼容方案

推荐版本检测策略：

kotlin复制fun canUseNativeFreeform(): Boolean {
    return Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE && 
           packageManager.hasSystemFeature(PackageManager.FEATURE_FREEFORM_WINDOW_MANAGEMENT)
}

6. 设计模式最佳实践

6.1 单Activity多窗口架构

kotlin复制class MainActivity : AppCompatActivity() {
    fun openNewWindow(content: Uri) {
        val intent = Intent(this, DetailActivity::class.java).apply {
            data = content
            addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT or
                    Intent.FLAG_ACTIVITY_MULTIPLE_TASK or
                    Intent.FLAG_ACTIVITY_NEW_TASK)
        }
        startActivity(intent)
    }
}

6.2 窗口状态持久化

kotlin复制override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    outState.putIntArray("WINDOW_POSITION", 
        intArrayOf(window.attributes.x, window.attributes.y))
    outState.putIntArray("WINDOW_SIZE", 
        intArrayOf(window.attributes.width, window.attributes.height))
}

override fun onRestoreInstanceState(savedInstanceState: Bundle) {
    super.onRestoreInstanceState(savedInstanceState)
    val position = savedInstanceState.getIntArray("WINDOW_POSITION")
    val size = savedInstanceState.getIntArray("WINDOW_SIZE")
    window.attributes = window.attributes.apply {
        x = position?.get(0) ?: 0
        y = position?.get(1) ?: 0
        width = size?.get(0) ?: WRAP_CONTENT
        height = size?.get(1) ?: WRAP_CONTENT
    }
}

7. 测试验证方案

7.1 UI自动化测试

使用UI Automator进行窗口操作测试：

kotlin复制@RunWith(AndroidJUnit4::class)
class FreeformWindowTest {
    @get:Rule
    val rule = ActivityScenarioRule(MainActivity::class.java)

    @Test
    fun testWindowDrag() {
        val device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
        
        // 定位窗口标题栏
        val titleBar = device.findObject(
            UiSelector().resourceId("com.example:id/title_bar")
        )
        
        // 模拟拖拽操作
        titleBar.dragTo(
            device.findObject(UiSelector().resourceId("com.example:id/target_area")),
            50
        )
        
        // 验证新位置
        assertThat(titleBar.bounds.left).isGreaterThan(300)
    }
}

7.2 多窗口场景测试矩阵

8. 进阶开发技巧

8.1 动态窗口样式切换

kotlin复制fun toggleWindowStyle(activity: Activity, isDark: Boolean) {
    val attrs = activity.window.attributes
    attrs.windowAnimations = if (isDark) {
        R.style.FreeformWindowAnimation_Dark
    } else {
        R.style.FreeformWindowAnimation_Light
    }
    activity.window.attributes = attrs
    
    // 动态修改DecorView背景
    activity.window.decorView.background = if (isDark) {
        ColorDrawable(Color.BLACK)
    } else {
        ColorDrawable(Color.WHITE)
    }
}

8.2 窗口吸附效果实现

kotlin复制class EdgeSnapHelper(private val sensitivity: Int = 50) : View.OnTouchListener {
    private var initialX = 0f
    private var initialY = 0f
    
    override fun onTouch(v: View, event: MotionEvent): Boolean {
        when (event.action) {
            MotionEvent.ACTION_DOWN -> {
                initialX = event.rawX
                initialY = event.rawY
            }
            MotionEvent.ACTION_MOVE -> {
                val params = v.layoutParams as WindowManager.LayoutParams
                params.x = (event.rawX - initialX).toInt()
                params.y = (event.rawY - initialY).toInt()
                
                // 边缘吸附检测
                val display = (v.context.getSystemService(WINDOW_SERVICE) as WindowManager)
                    .defaultDisplay
                val size = Point()
                display.getSize(size)
                
                if (abs(params.x) < sensitivity) params.x = 0
                if (abs(params.y) < sensitivity) params.y = 0
                if (abs(params.x + v.width - size.x) < sensitivity) {
                    params.x = size.x - v.width
                }
                if (abs(params.y + v.height - size.y) < sensitivity) {
                    params.y = size.y - v.height
                }
                
                windowManager.updateViewLayout(v, params)
            }
        }
        return true
    }
}

8.3 窗口阴影效果优化

在res/drawable/window_shadow.xml中定义：

xml复制<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <solid android:color="@android:color/transparent" />
    <padding android:left="5dp"
             android:top="5dp"
             android:right="5dp"
             android:bottom="5dp" />
    <stroke android:width="1dp"
            android:color="#33000000" />
</shape>

然后在窗口根布局应用：

xml复制<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/window_shadow"
    android:clipToPadding="false">
    <!-- 窗口内容 -->
</FrameLayout>