Migrating to FP-WindowManager: Compatibility, Troubleshooting, and Case Studies

Migrating to FP-WindowManager: Compatibility, Troubleshooting, and Case Studies

Compatibility checklist

• Supported platforms: Android (API 14+ via Jetpack WindowManager compatibility; assume Android unless FP-WindowManager is a custom repo).
• Language: Kotlin-first APIs; Java adapters available (window-java).
• Dependency: add Google Maven and implementation “androidx.window:window:1.5.1” (adjust to latest stable).
• UI frameworks: Works with Activities, Fragments, and Compose; activity-embedding APIs require activity-based app changes for large-screen splits.
• Minimum layout assumptions: Material guidance: 600dp min width for two-pane/split behaviors.

Migration steps (practical)

1. Add repository and dependency:

   Code
   Copy CodeCopied
   dependencyResolutionManagement { repositories { google() } } implementation “androidx.window:window:1.5.1” 

2. Replace any custom window-size/hinge detection with WindowMetricsCalculator and WindowInfoTracker flows.
3. For foldable/folding features use FoldingFeature APIs (detect orientation, separating/occluding).
4. If migrating activity-embedding/split rules:
   • Add embedding dependency (androidx.window.embedding).
   • Add manifest initializer