{i>Information architecture

Android 8.0 memperkenalkan arsitektur informasi baru untuk aplikasi Setelan guna menyederhanakan cara pengaturan setelan dan memudahkan pengguna menemukan setelan dengan cepat untuk menyesuaikan perangkat Android mereka. Android 9 memperkenalkan beberapa penyempurnaan untuk menyediakan lebih banyak fungsi Pengaturan dan penerapan yang lebih mudah.

Contoh dan sumber

Sebagian besar halaman di Pengaturan saat ini diterapkan menggunakan kerangka kerja baru. Contoh yang bagus adalah DisplaySettings: packages/apps/Settings/src/com/android/settings/DisplaySettings.java

Jalur file untuk komponen penting tercantum di bawah ini:

  • Kunci Kategori : packages/SettingsLib/src/com/android/settingslib/drawer/CategoryKey.java
  • DashboardFragmentRegistry : packages/apps/Settings/src/com/android/settings/dashboard/DashboardFragmentRegistry.java
  • DashboardFragment : packages/apps/Settings/src/com/android/settings/dashboard/DashboardFragment.java
  • AbstrakPreferenceController : frameworks/base/packages/SettingsLib/src/com/android/settingslib/core/AbstractPreferenceController.java
  • BasePreferenceController (diperkenalkan di Android 9): packages/apps/Settings/src/com/android/settings/core/BasePreferenceController.java

Penerapan

Produsen perangkat didorong untuk mengadaptasi arsitektur informasi Pengaturan yang ada dan menyisipkan halaman pengaturan tambahan sesuai kebutuhan untuk mengakomodasi fitur khusus mitra. Memindahkan preferensi dari halaman lama (diimplementasikan sebagai SettingsPreferencePage ) ke halaman baru (diimplementasikan menggunakan DashboardFragment ) bisa jadi rumit. Preferensi dari halaman lama kemungkinan tidak diterapkan dengan PreferenceController .

Jadi saat memindahkan preferensi dari laman lama ke laman baru, Anda perlu membuat PreferenceController dan memindahkan kode ke pengontrol sebelum membuat instance di DashboardFragment baru. API yang diperlukan PreferenceController dijelaskan dalam namanya dan didokumentasikan dalam Javadoc.

Sangat disarankan untuk menambahkan unit test untuk setiap PreferenceController . Jika perubahan diserahkan ke AOSP, maka diperlukan unit test. Untuk mendapatkan informasi selengkapnya tentang cara menulis pengujian berbasis Robolectric, lihat file readme packages/apps/Settings/tests/robotests/README.md .

Arsitektur informasi bergaya plugin

Setiap item pengaturan diimplementasikan sebagai Preferensi. Preferensi dapat dengan mudah dipindahkan dari satu halaman ke halaman lainnya.

Untuk memudahkan pemindahan beberapa setelan, Android 8.0 memperkenalkan fragmen host bergaya plugin yang berisi item setelan. Item pengaturan dimodelkan sebagai pengontrol gaya plugin. Oleh karena itu, halaman pengaturan dibuat oleh satu fragmen host dan beberapa pengontrol pengaturan.

Fragmen Dasbor

DashboardFragment adalah host pengontrol preferensi bergaya plugin. Fragmen ini mewarisi dari PreferenceFragment dan memiliki kait untuk memperluas dan memperbarui daftar preferensi statis dan daftar preferensi dinamis.

Preferensi statis

Daftar preferensi statis ditentukan dalam XML menggunakan tag <Preference> . Implementasi DashboardFragment menggunakan metode getPreferenceScreenResId() untuk menentukan file XML mana yang berisi daftar preferensi statis untuk ditampilkan.

Preferensi dinamis

Item dinamis mewakili ubin dengan maksud, yang mengarah ke Aktivitas eksternal atau internal. Biasanya maksudnya mengarah ke halaman pengaturan yang berbeda. Misalnya, item setelan "Google" di beranda Setelan adalah item dinamis. Item dinamis didefinisikan dalam AndroidManifest (dibahas di bawah) dan dimuat melalui FeatureProvider (didefinisikan sebagai DashboardFeatureProvider ).

Pengaturan dinamis lebih penting daripada pengaturan yang dikonfigurasi secara statis, jadi biasanya pengembang harus menerapkan pengaturan sebagai pengaturan statis. Namun pengaturan dinamis dapat berguna bila salah satu hal berikut ini benar:

  • Pengaturan ini tidak diterapkan secara langsung di aplikasi Pengaturan (seperti memasukkan pengaturan yang diterapkan oleh aplikasi OEM/Operator).
  • Pengaturan tersebut akan muncul di halaman beranda Pengaturan.
  • Anda sudah memiliki Aktivitas untuk pengaturan dan tidak ingin mengimplementasikan konfigurasi statis tambahan.

Untuk mengonfigurasi Aktivitas sebagai pengaturan dinamis, lakukan hal berikut:

  • Tandai aktivitas sebagai pengaturan dinamis dengan menambahkan filter maksud ke aktivitas.
  • Beri tahu aplikasi Pengaturan kategori mana yang termasuk. Kategori adalah sebuah konstanta, yang didefinisikan dalam CategoryKey .
  • Opsional: Tambahkan teks ringkasan saat pengaturan ditampilkan.

Berikut adalah contoh yang diambil dari aplikasi Pengaturan untuk DisplaySettings .

<activity android:name="Settings$DisplaySettingsActivity"
                   android:label="@string/display_settings"
                   android:icon="@drawable/ic_settings_display">
             <!-- Mark the activity as a dynamic setting -->
              <intent-filter>
                     <action android:name="com.android.settings.action.IA_SETTINGS" />
              </intent-filter>
             <!-- Tell Settings app which category it belongs to -->
              <meta-data android:name="com.android.settings.category"
                     android:value="com.android.settings.category.ia.homepage" />
             <!-- Add a summary text when the setting is displayed -->
              <meta-data android:name="com.android.settings.summary"
                     android:resource="@string/display_dashboard_summary"/>
             </activity>

Pada waktu render, fragmen akan meminta daftar Preferensi dari XML statis dan setelan dinamis yang ditentukan dalam AndroidManifest . Baik PreferenceController ditentukan dalam kode Java atau XML, DashboardFragment mengelola logika penanganan setiap pengaturan melalui PreferenceController (dibahas di bawah). Kemudian ditampilkan di UI sebagai daftar campuran.

Pengontrol Preferensi

Terdapat perbedaan antara penerapan PreferenceController di Android 9 dan Android 8.x, seperti yang dijelaskan di bagian ini.

PreferenceController di rilis Android 9

PreferenceController berisi semua logika untuk berinteraksi dengan preferensi, termasuk menampilkan, memperbarui, mengindeks pencarian, dll.

Antarmuka PreferenceController didefinisikan sebagai BasePreferenceController . Misalnya, lihat kode di packages/apps/Settings/src/com/android/settings/core/ BasePreferenceController.java

Ada beberapa subkelas BasePreferenceController , masing-masing memetakan ke gaya UI tertentu yang didukung aplikasi Pengaturan secara default. Misalnya, TogglePreferenceController memiliki API yang secara langsung memetakan cara pengguna berinteraksi dengan UI preferensi berbasis tombol.

BasePreferenceController memiliki API seperti getAvailabilityStatus() , displayPreference() , handlePreferenceTreeClicked(), dll. Dokumentasi mendetail untuk setiap API ada di kelas antarmuka.

Batasan penerapan BasePreferenceController (dan subkelasnya seperti TogglePreferenceController ) adalah tanda tangan konstruktor harus cocok dengan salah satu hal berikut:

  • public MyController(Context context, String key) {}
  • public MyController(Context context) {}

Saat memasang preferensi pada fragmen, dasbor menyediakan metode untuk melampirkan PreferenceController sebelum waktu tampilan. Pada waktu instalasi, pengontrol dihubungkan ke fragmen sehingga semua kejadian relevan di masa depan dikirim ke pengontrol.

DashboardFragment menyimpan daftar PreferenceController di layar. Pada onCreate() fragmen, semua pengontrol dipanggil untuk metode getAvailabilityStatus() , dan jika hasilnya benar, displayPreference() dipanggil untuk memproses logika tampilan. getAvailabilityStatus() juga penting untuk memberi tahu kerangka Pengaturan item mana yang tersedia selama pencarian.

PreferenceController di rilis Android 8.x

PreferenceController berisi semua logika untuk berinteraksi dengan preferensi, termasuk menampilkan, memperbarui, mengindeks pencarian. dll.

Sesuai dengan interaksi preferensi, antarmuka PreferenceController memiliki API isAvailable() , displayPreference() , handlePreferenceTreeClicked() dll. Dokumentasi terperinci tentang setiap API dapat ditemukan di kelas antarmuka.

Saat memasang preferensi pada fragmen, dasbor menyediakan metode untuk melampirkan PreferenceController sebelum waktu tampilan. Pada waktu instalasi, pengontrol dihubungkan ke fragmen sehingga semua kejadian relevan di masa depan dikirim ke pengontrol.

DashboardFragment menyimpan daftar PreferenceControllers di layar. Pada onCreate() fragmen, semua pengontrol dipanggil untuk metode isAvailable() , dan jika hasilnya benar, displayPreference() dipanggil untuk memproses logika tampilan.

Menggunakan DashboardFragment

Memindahkan preferensi dari halaman A ke B

Jika preferensi tercantum secara statis di file XML preferensi laman asli, ikuti prosedur pemindahan statis untuk rilis Android Anda di bawah. Jika tidak, ikuti prosedur pemindahan Dinamis untuk rilis Android Anda.

Pergerakan statis di Android 9

  1. Temukan file XML preferensi untuk halaman asli dan halaman tujuan. Anda dapat menemukan informasi ini dari metode getPreferenceScreenResId() halaman.
  2. Hapus preferensi dari XML halaman asli.
  3. Tambahkan preferensi ke XML halaman tujuan.
  4. Hapus PreferenceController untuk preferensi ini dari implementasi Java halaman asli. Biasanya ada di createPreferenceControllers() . Pengontrol mungkin dideklarasikan dalam XML secara langsung.

    Catatan : Preferensi mungkin tidak memiliki PreferenceController .

  5. Buat instance PreferenceController di createPreferenceControllers() halaman tujuan. Jika PreferenceController didefinisikan dalam XML di halaman lama, tentukan juga dalam XML untuk halaman baru.

Pergerakan dinamis di Android 9

  1. Temukan kategori mana yang dihosting oleh halaman asli dan tujuan. Anda dapat menemukan informasi ini di DashboardFragmentRegistry .
  2. Buka file AndroidManifest.xml yang berisi setelan yang perlu Anda pindahkan dan temukan entri Aktivitas yang mewakili setelan ini.
  3. Tetapkan nilai metadata aktivitas untuk com.android.settings.category ke kunci kategori halaman baru.

Pergerakan statis di rilis Android 8.x

  1. Temukan file XML preferensi untuk halaman asli dan halaman tujuan.
    2. Anda dapat menemukan informasi ini dari metode getPreferenceScreenResId() halaman.
  2. Hapus preferensi di XML halaman asli.
  3. Tambahkan preferensi ke XML halaman tujuan.
  4. Hapus PreferenceController untuk preferensi ini di implementasi Java halaman asli. Biasanya ada di getPreferenceControllers() .

    5. Catatan : Ada kemungkinan preferensi tidak memiliki PreferenceController .

  5. Buat instance PreferenceController di getPreferenceControllers() laman tujuan.

Pergerakan dinamis dalam rilis Android 8.x

  1. Temukan kategori mana yang dihosting oleh halaman asli dan tujuan. Anda dapat menemukan informasi ini di DashboardFragmentRegistry .
  2. Buka file AndroidManifest.xml yang berisi setelan yang perlu Anda pindahkan dan temukan entri Aktivitas yang mewakili setelan ini.
  3. Ubah nilai metadata aktivitas untuk com.android.settings.category , setel titik nilai ke kunci kategori laman baru.

Membuat preferensi baru di halaman

Jika preferensi tercantum secara statis di file XML preferensi laman asli, ikuti prosedur statis di bawah. Jika tidak, ikuti prosedur dinamis .

Membuat preferensi statis

  1. Temukan file XML preferensi untuk halaman tersebut. Anda dapat menemukan informasi ini dari metode getPreferenceScreenResId() halaman.
  2. Tambahkan item Preferensi baru di XML. Pastikan ia memiliki android:key yang unik.
  3. Tentukan PreferenceController untuk preferensi ini dalam metode getPreferenceControllers() halaman.
    • Di Android 8.x dan opsional di Android 9, buat instance PreferenceController untuk preferensi ini di metode createPreferenceControllers() halaman.

      Jika preferensi ini sudah ada di tempat lain, kemungkinan sudah ada PreferenceController untuknya. Anda dapat menggunakan kembali PreferenceController tanpa membuat yang baru.

    • Mulai Android 9, Anda dapat memilih untuk mendeklarasikan PreferenceController dalam XML di samping preferensi. Misalnya:
      <Preference
        android:key="reset_dashboard"
        android:title="@string/reset_dashboard_title"
        settings:controller="com.android.settings.system.ResetPreferenceController"/>

Menciptakan preferensi dinamis

  1. Temukan kategori mana yang dihosting oleh halaman asli dan tujuan. Anda dapat menemukan informasi ini di DashboardFragmentRegistry .
  2. Buat Aktivitas baru di AndroidManifest
  3. Tambahkan metadata yang diperlukan ke Aktivitas baru untuk menentukan pengaturan. Tetapkan nilai metadata untuk com.android.settings.category ke nilai yang sama yang ditentukan pada langkah 1.

Buat halaman baru

  1. Buat fragmen baru, yang mewarisi DashboardFragment .
  2. Tentukan kategorinya di DashboardFragmentRegistry .

    Catatan: Langkah ini opsional. Jika Anda tidak memerlukan preferensi dinamis apa pun di halaman ini, Anda tidak perlu memberikan kunci kategori.

  3. Ikuti langkah-langkah untuk menambahkan pengaturan yang diperlukan untuk halaman ini. Untuk informasi lebih lanjut, lihat bagian Implementasi .

Validasi

  • Jalankan tes robotelektrik di Pengaturan. Semua tes yang ada dan yang baru harus lulus.
  • Bangun dan instal Pengaturan, lalu buka halaman yang sedang dimodifikasi secara manual. Halaman ini harus segera diperbarui.