Как открыть новый фрагмент PreferenceFragment из текущего, используя новый API Android-X? - PullRequest
0 голосов
/ 09 октября 2018

Фон

В предыдущих версиях библиотеки поддержки мы могли использовать заголовки, чтобы в главном меню отображался экран настроек, каждый из которых открывал новый экран настроек (фрагмент).

Проблема

Теперь заголовки исчезли (как написано здесь ) в течение некоторого времени, и я думаю, что это стало хуже на android-x:

Одна вещь, которую вы здесь не заметите, это заголовки настроек, и вы будете совершенно правы.Однако это не означает, что единый список предпочтений должен охватывать 10-дюймовый экран планшета.Вместо этого ваша деятельность может реализовать OnPreferenceStartFragmentCallback ( ссылка ) для обработки предпочтений с помощью атрибута app: фрагмент или OnPreferenceStartScreenCallback ( ссылка ) для обработки предпочтений PreferenceScreen.Это позволяет вам создать стиль PreferenceFragmentCompat в стиле «заголовка» на одной панели и использовать эти обратные вызовы для замены второй панели, не работая с двумя отдельными типами файлов XML.

Дело в том, что я не могу использовать этив новом android-x API.

Каждый фрагмент имеет свое собственное дерево настроек XML (используя setPreferencesFromResource в пределах onCreatePreferences), но каждое решение, которое я придумал, либо ничего не делало, либо зависало.

Чтобы выразить это визуально, я пытаюсь достичь этого:

enter image description here

Поскольку существует несколько субэкраны настроек, было бы очень грязно, если бы все предпочтения всех них были помещены в один XML-файл главного экрана настроек.

То, что я пробовал

Единственное, что мне удалось, это использовать PreferenceScreen для хранения настроек подэкрана, который должен отображаться.

Вот рабочий код (проект доступен здесь ) такой вещи:

preferences.xml

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" android:title="Demo">

    <PreferenceScreen
        android:key="screen_preference" android:summary="Shows another screen of preferences"
        android:title="Screen preferenc">

        <CheckBoxPreference
            android:key="next_screen_checkbox_preference"
            android:summary="Preference that is on the next screen but same hierarchy"
            android:title="Toggle preference"/>

    </PreferenceScreen>

</PreferenceScreen>

MainActivity.kt

class MainActivity : AppCompatActivity(), PreferenceFragmentCompat.OnPreferenceStartScreenCallback {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
        if (savedInstanceState == null)
            supportFragmentManager.beginTransaction().replace(android.R.id.content, PrefsFragment()).commit()
    }

    override fun onPreferenceStartScreen(caller: PreferenceFragmentCompat, pref: PreferenceScreen): Boolean {
        val f = PrefsFragment()
        val args = Bundle(1)
        args.putString(PreferenceFragmentCompat.ARG_PREFERENCE_ROOT, pref.key)
        f.arguments = args
        supportFragmentManager.beginTransaction().replace(android.R.id.content, f).addToBackStack(null).commit()
        return true
    }

    class PrefsFragment : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences, rootKey)
        }
    }
}

Но, как я уже писал, это не то, что я пытаюсь сделать.Я хочу иметь несколько классов, которые расширяют PreferenceFragmentCompat, каждый со своим собственным XML-файлом, который будет открыт из основного.

Вот что я пробовал (и не смог):

  1. Установите «android: фрагмент» для PreferenceScreen, чтобы указывать на новые классы фрагментов, аналогичные заголовкам.Это вообще ничего не сделало.

  2. Используйте обычное предпочтение и выберите прослушиватель для него, который выполнит транзакцию фрагмента, как показано в исходном коде.Это вызвало сбой, который говорит что-то вроде «Объект предпочтения с ключом screen_preference не является PreferenceScreen».

  3. Пытался избегать использования ARG_PREFERENCE_ROOT, но имел тот же сбой, что и на # 2.

  4. Как и предполагалось здесь , я попытался вернуть this в функции getCallbackFragment, но это не помогло вообще.

Вопрос

Возможно ли иметь фрагмент основных настроек, просто позволяя пользователю переходить к другим фрагментам, не имея при этом никаких других предпочтений, которые ему принадлежат(внутри preferences.xml)?

Как?

Ответы [ 2 ]

0 голосов
/ 11 декабря 2018

То, что вы пробовали в 1), было правильным подходом - но вы не должны использовать теги <PreferenceScreen> для этого.

Ваш XML-ресурс должен выглядеть следующим образом:

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">

    <Preference
        app:key="screen_preference" 
        app:summary="Shows another screen of preferences"
        app:title="Screen preference"
        app:fragment="com.example.user.myapplication.MainActivity$PrefsFragment2"/>

</PreferenceScreen>

Кроме того, если вы используете версию Preference старше androidx.preference:preference:1.1.0-alpha01, вам потребуется реализовать onPreferenceStartFragment для обработки фрагментасделка.(в версии 1.1.0 alpha01 этот метод имеет реализацию по умолчанию, но вам все равно рекомендуется использовать собственную реализацию для настройки любых анимаций / переходов)

Это должно выглядеть примерно так:

override fun onPreferenceStartFragment(
        caller: PreferenceFragmentCompat,
        pref: Preference
): Boolean {
    // Instantiate the new Fragment
    val args = pref.extras
    val fragment = supportFragmentManager.fragmentFactory.instantiate(
            classLoader,
            pref.fragment,
            args
    ).apply {
        arguments = args
        setTargetFragment(caller, 0)
    }
    // Replace the existing Fragment with the new Fragment
    supportFragmentManager.beginTransaction()
            .replace(R.id.settings, fragment)
            .addToBackStack(null)
            .commit()
    return true
}

Для получения дополнительной информации вы можете просмотреть руководство Настройки и Пример предпочтений AndroidX


РЕДАКТИРОВАТЬ: образец первого решения после обновления доступен здесь .

Вот как это может работать (образец здесь ):

MainActivity.kt

class MainActivity : AppCompatActivity(), PreferenceFragmentCompat.OnPreferenceStartFragmentCallback {
    override fun onPreferenceStartFragment(caller: PreferenceFragmentCompat, pref: Preference): Boolean {
        //Note: this whole function won't be needed when using new version of fragment dependency (1.1.0 and above)
        val fragment = Fragment.instantiate(this, pref.fragment, pref.extras)
        fragment.setTargetFragment(caller, 0)
        supportFragmentManager.beginTransaction().replace(android.R.id.content, fragment).addToBackStack(null).commit()
        return true
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
        if (savedInstanceState == null)
            supportFragmentManager.beginTransaction().replace(android.R.id.content, PrefsFragment()).commit()
    }

    class PrefsFragment : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences, rootKey)
        }
    }

    class PrefsFragment2 : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences2, null)
        }
    }
}

preferences.xml

  <PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto">

    <Preference
      app:fragment="com.example.user.myapplication.MainActivity$PrefsFragment2" app:key="screen_preference" app:summary="Shows another screen of preferences"
      app:title="Screen preference"/>

  </PreferenceScreen>

preferences2.xml

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" android:title="Demo">

  <PreferenceCategory android:title="Category">
    <CheckBoxPreference
      android:key="next_screen_checkbox_preference" android:summary="AAAA" android:title="Toggle preference"/>
  </PreferenceCategory>

</PreferenceScreen>

зависимости gradle:

implementation 'androidx.appcompat:appcompat:1.0.2'
implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
implementation 'androidx.preference:preference:1.0.0'
0 голосов
/ 10 октября 2018

Хорошо, я нашел 2 возможных, но странных решения.

Я все еще хотел бы знать, существует ли официальный способ сделать это, потому что оба решения довольно странные.

Решение 1

В XML-файле предпочтений основных настроек для каждого вложенного элемента PreferenceScreen я поместил пустой тег Preference.

preferences.xml

<PreferenceScreen
    android:key="screen_preference" android:summary="Shows another screen of preferences"
    android:title="Screen preference">
    <Preference/>
</PreferenceScreen>

Я передаю ноль для второго аргумента setPreferencesFromResource в новомфрагмент подэкрана.

Вот код (проект доступен здесь ):

MainActivity.kt

class MainActivity : AppCompatActivity(), PreferenceFragmentCompat.OnPreferenceStartScreenCallback {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
        if (savedInstanceState == null)
            supportFragmentManager.beginTransaction().replace(android.R.id.content, PrefsFragment()).commit()
    }

    override fun onPreferenceStartScreen(caller: PreferenceFragmentCompat, pref: PreferenceScreen): Boolean {
        supportFragmentManager.beginTransaction().replace(android.R.id.content, PrefsFragment2()).addToBackStack(null).commit()
        return true
    }

    class PrefsFragment : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences, rootKey)
        }
    }

    class PrefsFragment2 : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences2, null)
        }
    }
}

Конечно, это нужно изменить, чтобы вы знали, какой фрагмент создать и добавить ...

Решение 2

Я использую обычный Preference вместо каждого PreferenceScreenи для каждого из них я выбираю добавить фрагмент по щелчку (проект доступен здесь ):

preferences.xml

<Preference
    android:key="screen_preference" android:summary="Shows another screen of preferences"
    android:title="Screen preference"/>

MainActivity.kt

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
        if (savedInstanceState == null)
            supportFragmentManager.beginTransaction().replace(android.R.id.content, PrefsFragment()).commit()
    }

    class PrefsFragment : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences, rootKey)
            setPreferenceToOpenFragmentAsNewPage(findPreference("screen_preference"), PrefsFragment2::class.java)
        }

        private fun setPreferenceToOpenFragmentAsNewPage(pref: Preference, java: Class<out PreferenceFragmentCompat>) {
            pref.onPreferenceClickListener = Preference.OnPreferenceClickListener {
                val fragment = java.newInstance()
                val args = Bundle(1)
                args.putString(PreferenceFragmentCompat.ARG_PREFERENCE_ROOT, pref.key)
                fragment.arguments = args
                activity!!.supportFragmentManager.beginTransaction().replace(android.R.id.content, fragment).addToBackStack(null).commit()
                true
            }
        }
    }

    class PrefsFragment2 : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences2, null)
        }
    }
}

РЕДАКТИРОВАТЬ: небольшая модификация второго решения может сделать его лучше:

preferences.xml

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" android:title="Demo">

    <Preference
        android:fragment="com.example.user.myapplication.MainActivity$PrefsFragment2" android:key="screen_preference"
        android:summary="Shows another screen of preferences" android:title="Screen preference"/>

</PreferenceScreen>

MainActivity.kt

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
        if (savedInstanceState == null)
            supportFragmentManager.beginTransaction().replace(android.R.id.content, PrefsFragment()).commit()
    }

    class PrefsFragment : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences, rootKey)
            setPreferenceToOpenFragmentAsNewPage(findPreference("screen_preference"))
        }

        private fun setPreferenceToOpenFragmentAsNewPage(pref: Preference) {
            pref.onPreferenceClickListener = Preference.OnPreferenceClickListener {
                val clazz = Class.forName(pref.fragment)
                val fragment: PreferenceFragmentCompat = clazz.newInstance() as PreferenceFragmentCompat
                val args = Bundle(1)
                args.putString(PreferenceFragmentCompat.ARG_PREFERENCE_ROOT, pref.key)
                fragment.arguments = args
                activity!!.supportFragmentManager.beginTransaction().replace(android.R.id.content, fragment).addToBackStack(null).commit()
                true
            }
        }
    }

    class PrefsFragment2 : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences2, null)
        }
    }

}

Обратите внимание, что вам необходимо добавить это в правила Proguard:

-keepnames public class * extends androidx.preference.PreferenceFragmentCompat

Еще одно усовершенствование решения № 2 заключается в том, что оно может обходить все предпочтения самостоятельно:

class PrefsFragment : BasePreferenceFragment() {
    override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
        setPreferencesFromResource(R.xml.preferences_headers, rootKey)
        val preferenceScreen = preferenceScreen
        val preferenceCount = preferenceScreen.preferenceCount
        for (i in 0 until preferenceCount) {
            val pref = preferenceScreen.getPreference(i)
            val fragmentClassName = pref.fragment
            if (fragmentClassName.isNullOrEmpty())
                continue
            pref.setOnPreferenceClickListener {
                showPreferenceFragment(activity!!, fragmentClassName)
                true
            }
        }
    }
}

companion object {
    @JvmStatic
    private fun showPreferenceFragment(activity: FragmentActivity, fragmentClassName: String) {
        val clazz = Class.forName(fragmentClassName)
        val fragment: PreferenceFragmentCompat = clazz.newInstance() as PreferenceFragmentCompat
        val fragmentsCount = activity.supportFragmentManager.fragments.size
        val transaction = activity.supportFragmentManager.beginTransaction().replace(android.R.id.content, fragment)
        if (fragmentsCount > 0)
            transaction.addToBackStack(null)
        transaction.commit()
    }
}

РЕДАКТИРОВАТЬ: кажется, первое решение было правильным, но нужно изменить,Проверьте ответ здесь .Полный образец доступен здесь .

...