Jetpack WindowManager: τι είναι, βιβλιοθήκη για αναδιπλούμενες συσκευές

Τι είναι το Jetpack WindowManager;

Jetpack WindowManager — μια βιβλιοθήκη από το πακέτο AndroidX που αφαιρεί την πολυπλοκότητα εργασίας με παράθυρα και διαμορφώσεις οθόνης σε συσκευές Android. Λύνει το πρόβλημα κατακερματισμού οθονών: από συμπαγή τηλέφωνα έως αναδιπλούμενες συσκευές και tablet με λειτουργία desktop.

Πριν από την εμφάνιση του WindowManager, οι προγραμματιστές χρησιμοποιούσαν το παλιό Display API και το Resources#getConfiguration, τα οποία δεν λάμβαναν υπόψη τις αναδιπλούμενες συσκευές και τις λειτουργίες multi-window. Το WindowManager παρέχει ένα ενοποιημένο API για όλα τα σενάρια: μία βιβλιοθήκη καλύπτει τα FoldingFeature, WindowMetrics, WindowSizeClass και ScreenContinuity. Αυτό μειώνει την ποσότητα boilerplate κώδικα και εξαλείφει σφάλματα κατά την προσαρμογή της διεπαφής σε διαφορετικές συσκευές.

Σύμφωνα με το Google I/O 2024, η σταθερή έκδοση 1.3 του Jetpack WindowManager περιλαμβάνει υποστήριξη για αισθητήρες μεντεσέ, API για τον προσδιορισμό γωνίας ανοίγματος και βελτιωμένη ενσωμάτωση με το Jetpack Compose. Η βιβλιοθήκη είναι συμβατή προς τα πίσω έως Android 10 (API 29) μέσω Support Library και προσαρμόζεται αυτόματα στις δυνατότητες της συσκευής.

FoldingFeature: εργασία με την αναδίπλωση της συσκευής

FoldingFeature — η κεντρική κλάση του Jetpack WindowManager για εργασία με αναδιπλούμενες συσκευές. Ενσωματώνει όλες τις πληροφορίες σχετικά με τη φυσική θέση αναδίπλωσης: κατάσταση (HALF_OPENED, FLAT, TABLE_TOP), προσανατολισμό (VERTICAL, HORIZONTAL), συντεταγμένες μεντεσέ και γωνία ανοίγματος σε μοίρες.

Καταστάσεις FoldingFeature

Η βιβλιοθήκη ορίζει τέσσερις καταστάσεις αναδίπλωσης. STATE_FLAT — η συσκευή είναι πλήρως ανοιγμένη, η οθόνη είναι επίπεδη. STATE_HALF_OPENED — η συσκευή είναι μερικώς διπλωμένη, η οθόνη βρίσκεται σε γωνία 30 έως 160 μοιρών. STATE_TABLE_TOP — η συσκευή στέκεται σε επιφάνεια σε στάση laptop. STATE_FULLY_OPENED — παλιά κατάσταση, αντικαταστάθηκε από FLAT στην έκδοση 1.2.

Προσανατολισμός και συντεταγμένες αναδίπλωσης

Η αναδίπλωση μπορεί να είναι κατακόρυφη (VERTICAL_FOLD) ή οριζόντια (HORIZONTAL_FOLD). Bounds — ένα ορθογώνιο που περιγράφει την περιοχή αναδίπλωσης στις συντεταγμένες του παραθύρου της εφαρμογής. Ο προγραμματιστής χρησιμοποιεί αυτά τα δεδομένα για να τοποθετήσει στοιχεία διεπαφής πάνω και κάτω από την αναδίπλωση, αποφεύγοντας την επικάλυψη περιεχομένου με την κρίσιμη περιοχή.

val windowManager = WindowManager(context)
val flow = windowManager.foldingFeature()

flow.collect { feature: FoldingFeature ->
    when (feature.state) {
        FoldingFeature.State.FLAT -> showFullScreen(feature.bounds)
        FoldingFeature.State.HALF_OPENED -> splitContentAcrossFold(feature.bounds)
        FoldingFeature.State.TABLE_TOP -> enableTouchpadMode()
    }
}

WindowMetrics και WindowSizeClass

WindowMetrics — API για λήψη ακριβών μεγεθών παραθύρου εφαρμογής, διαθέσιμο από το WindowManager 1.0. Σε αντίθεση με το Display#getSize, το WindowMetrics λαμβάνει υπόψη τη λειτουργία multi-window, το DeX και την ελεύθερη μορφή παραθύρου. Οι μετρήσεις επιστρέφουν currentWindowMetrics (τρέχον μέγεθος) και maximumWindowMetrics (μέγιστο δυνατό μέγεθος στη συσκευή).

WindowSizeClass — ένας ταξινομητής που εμφανίστηκε στο WindowManager 1.1. Χωρίζει τις οθόνες σε τρεις κατηγορίες: Compact (πλάτος μικρότερο από 600dp — τηλέφωνο), Medium (600–840dp — tablet σε κατακόρυφο προσανατολισμό) και Expanded (πάνω από 840dp — tablet σε οριζόντιο προσανατολισμό). Αυτή η κλάση απλοποιεί την προσαρμοστική διάταξη, αντικαθιστώντας δεκάδες ελέγχους μεγέθους με μία ταξινόμηση.

class MyComposable {
    @Composable
    fun AdaptiveLayout(windowSizeClass: WindowSizeClass) {
        when (windowSizeClass.widthSizeClass) {
            WindowWidthSizeClass.Compact -> CompactScreen()
            WindowWidthSizeClass.Expanded -> ExpandedScreen()
            else -> MediumScreen()
        }
    }
}

ScreenContinuityController και συνέχεια οθόνης

ScreenContinuityController — ένα στοιχείο του WindowManager υπεύθυνο για τη διατήρηση της κατάστασης Activity κατά την αλλαγή διαμόρφωσης της αναδιπλούμενης συσκευής. Όταν ο χρήστης ξεδιπλώνει ή διπλώνει το τηλέφωνο, ο ελεγκτής ειδοποιεί την εφαρμογή για τη νέα στάση και παρέχει μηχανισμούς για ομαλή μετάβαση.

Ο ελεγκτής καταχωρεί ακροατές μέσω registerContinuityListener, ο οποίος λαμβάνει ένα callback με αντικείμενο FoldingFeature. Σε κάθε αλλαγή στάσης, το callback ενεργοποιείται πριν από την αναδημιουργία του Activity, δίνοντας στον προγραμματιστή τη δυνατότητα να αποθηκεύσει χειροκίνητα την κατάσταση. Εάν η εφαρμογή χρησιμοποιεί ViewModel, δεν απαιτείται πρόσθετη επεξεργασία — τα δεδομένα αποθηκεύονται αυτόματα.

ScreenContinuity στο Jetpack Compose

Οι εφαρμογές Compose απολαμβάνουν τα πλεονεκτήματα του ScreenContinuity μέσω LocalWindowSizeClass και CompositionLocalProvider. Τα στοιχεία ανασυντίθενται αυτόματα όταν αλλάζουν τα WindowMetrics. Το rememberSaveable διατηρεί την κατάσταση μεταξύ ανασυνθέσεων, και το Modifier.windowInsets λαμβάνει υπόψη τις περιοχές συστήματος της οθόνης.

val controller = WindowManager(context).screenContinuityController
controller.registerContinuityListener { feature ->
    if (feature.state == FoldingFeature.State.FLAT) {
        logContinuityEvent("Device unfolded")
    }
}

Παραδείγματα ενσωμάτωσης σε Kotlin

Ας εξετάσουμε ένα πλήρες παράδειγμα Activity που χρησιμοποιεί το Jetpack WindowManager για προσαρμογή της διεπαφής σε διαφορετικές στάσεις αναδιπλούμενης συσκευής. Η WindowManagerActivity εγγράφεται στις αλλαγές FoldingFeature μέσω Flow API και εναλλάσσει τη διάταξη μεταξύ λειτουργίας μονού και διπλού πλαισίου.

class WindowManagerActivity : AppCompatActivity() {
    private lateinit var binding: ActivityWindowBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityWindowBinding.inflate(layoutInflater)
        setContentView(binding.root)

        val windowManager = WindowManager(this)
        val metrics = windowManager.currentWindowMetrics

        if (metrics.bounds.width() > dpToPx(600)) {
            showDualPaneLayout()
        } else {
            showSinglePaneLayout()
        }
    }

    private fun showDualPaneLayout() {
        binding.content.layoutManager = GridLayoutManager(this, 2)
    }

    private fun showSinglePaneLayout() {
        binding.content.layoutManager = LinearLayoutManager(this)
    }
}

Το παράδειγμα δείχνει ένα βασικό σενάριο: η εφαρμογή ελέγχει τα WindowMetrics και επιλέγει διάταξη ενός ή δύο πλαισίων. Σε πραγματικά έργα, συνιστάται η χρήση WindowSizeClass για πιο ευέλικτη προσαρμογή και FoldingFeature για το χειρισμό αναδιπλούμενων συσκευών. Η βιβλιοθήκη υποστηρίζει επίσης seamless transition — ομαλή κίνηση κατά την εναλλαγή μεταξύ διατάξεων.

Δοκιμή και εντοπισμός σφαλμάτων WindowManager

Android Studio περιλαμβάνει ενσωματωμένα εργαλεία για τη δοκιμή του Jetpack WindowManager. Ο εξομοιωτής υποστηρίζει αναδιπλούμενες συσκευές (Pixel Fold, Galaxy Z Fold) με εναλλαγή στάσεων μέσω της καρτέλας Folding Postures. Το Layout Inspector δείχνει τα τρέχοντα WindowMetrics και τα όρια FoldingFeature σε πραγματικό χρόνο.

Εντοπισμός σφαλμάτων μέσω ADB

Η εντολή adb shell dumpsys window displays εμφανίζει πληροφορίες για όλες τις συνδεδεμένες οθόνες και τις διαμορφώσεις τους. Για προσομοίωση αναδίπλωσης, χρησιμοποιήστε adb shell am broadcast -a android.intent.action.SCREEN_ON με πρόσθετες παραμέτρους στάσης. Το WindowManager καταγράφει όλες τις αλλαγές FoldingFeature μέσω WindowManager#logState.

Τυπικά σφάλματα

Τα κύρια προβλήματα κατά την ενσωμάτωση — αγνόηση ενημερώσεων WindowMetrics σε λειτουργία multi-window, εσφαλμένη επεξεργασία bounds σε κατακόρυφη αναδίπλωση και έλλειψη δοκιμών σε όλες τις στάσεις. Συνιστάται η δοκιμή κάθε στάσης ξεχωριστά και ο έλεγχος συμπεριφοράς κατά την εναλλαγή μεταξύ τους. Η χρήση WindowSizeClass αντί χειροκίνητων ελέγχων μεγέθους μειώνει τον αριθμό σφαλμάτων κατά 60%.