Що використовувати замість "addPreferencesFromResource" в PreferenceActivity?

Щойно я помітив той факт, що метод addPreferencesFromResource(int preferencesResId)позначений застарілим у документації на Android ( Reference Entry ).

На жаль, в описі методу не передбачений альтернативний метод.

Який метод слід використовувати замість цього, щоб підключити preferenceScreen.xml до відповідного PreferenceActivity?

В описі методу не передбачений альтернативний метод, оскільки бажаний підхід (на рівні 11 API) полягає у створенні об'єктів PreferenceFragment для завантаження ваших уподобань з файлу ресурсу. Дивіться зразок коду тут: PreferenceActivity

Щоб додати більше інформації до правильної відповіді вище, прочитавши приклад від Android-er, я виявив, що ви можете легко перетворити свою активність у вибраний фрагмент. Якщо у вас є така діяльність:

public class MyPreferenceActivity extends PreferenceActivity
{
    @Override
    protected void onCreate(final Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        addPreferencesFromResource(R.xml.my_preference_screen);
    }
}

Єдині зміни, які вам доведеться внести, - це створити внутрішній клас фрагмента, перемістити addPreferencesFromResources()фрагмент у фрагмент та викликати фрагмент із дії, наприклад:

public class MyPreferenceActivity extends PreferenceActivity
{
    @Override
    protected void onCreate(final Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        getFragmentManager().beginTransaction().replace(android.R.id.content, new MyPreferenceFragment()).commit();
    }

    public static class MyPreferenceFragment extends PreferenceFragment
    {
        @Override
        public void onCreate(final Bundle savedInstanceState)
        {
            super.onCreate(savedInstanceState);
            addPreferencesFromResource(R.xml.my_preference_screen);
        }
    }
}

Можуть бути й інші тонкощі щодо складніших уподобань з фрагментів; якщо так, я сподіваюся, що хтось їх тут помітить.

@Garret Wilson Дуже дякую! Як нооб для кодування Android, я стільки годин зациклювався на проблемі сумісності налаштувань, і я вважаю таким невтішним, що вони зневажили використання деяких методів / підходів для нових, які не підтримуються старими API, таким чином потрібно вдаватися до всіляких обхідних завдань, щоб ваш додаток працював у широкому діапазоні пристроїв. Це справді засмучує!

Ваш клас чудовий, тому що він дозволяє вам продовжувати працювати в нових API-інтерфейсах за такими ж параметрами, як раніше, але він не сумісний із зворотним. Оскільки я намагаюся охопити широкий спектр пристроїв, я трохи попрацював з ним, щоб він працював як на пристроях перед API 11, так і в новіших API:

import android.annotation.TargetApi;
import android.os.Bundle;
import android.preference.PreferenceActivity;
import android.preference.PreferenceFragment;

public class MyPrefsActivity extends PreferenceActivity
{
    private static int prefs=R.xml.myprefs;

    @Override
    protected void onCreate(final Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        try {
            getClass().getMethod("getFragmentManager");
            AddResourceApi11AndGreater();
        } catch (NoSuchMethodException e) { //Api < 11
            AddResourceApiLessThan11();
        }
    }

    @SuppressWarnings("deprecation")
    protected void AddResourceApiLessThan11()
    {
        addPreferencesFromResource(prefs);
    }

    @TargetApi(11)
    protected void AddResourceApi11AndGreater()
    {
        getFragmentManager().beginTransaction().replace(android.R.id.content,
                new PF()).commit();
    }

    @TargetApi(11)
    public static class PF extends PreferenceFragment
    {       
        @Override
        public void onCreate(final Bundle savedInstanceState)
        {
            super.onCreate(savedInstanceState);
            addPreferencesFromResource(MyPrefsActivity.prefs); //outer class
            // private members seem to be visible for inner class, and
            // making it static made things so much easier
        }
    }
}

Тестується в двох емуляторах (2.2 та 4.2) із успіхом.

Чому мій код виглядає так хитро:

Я прихильник кодування Android, і я не найбільший шанувальник Java.

Щоб уникнути застарілого попередження та змусити Eclipse дозволити мені компілювати, я повинен був вдатися до анотацій, але, здається, вони впливають лише на класи або методи, тому мені довелося перенести код на два нові методи, щоб скористатися цим.

Мені б не хотілося двічі писати свій ідентифікатор ресурсу xml, коли я копіюю та вставляю клас для нового PreferenceActivity, тому я створив нову змінну для зберігання цього значення.

Сподіваюся, це стане в нагоді комусь іншому.

PS: Вибачте за мої переконані погляди, але коли ви з’явитесь нові і знайдете такі перешкоди, ви можете не допомогти, але зірватися!

Мій підхід дуже близький до Гаррета Вілсона (спасибі, я проголосував за вас;)

Крім того, це забезпечує сумісність з Android <3.

Я щойно визнав, що моє рішення ще ближче до рішення Кевіна Ремо . Це просто чистіший тріщинець (оскільки він не покладається на тріщину "очікування" антипатерн ).

public class MyPreferenceActivity extends PreferenceActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
            onCreatePreferenceActivity();
        } else {
            onCreatePreferenceFragment();
        }
    }

    /**
     * Wraps legacy {@link #onCreate(Bundle)} code for Android < 3 (i.e. API lvl
     * < 11).
     */
    @SuppressWarnings("deprecation")
    private void onCreatePreferenceActivity() {
        addPreferencesFromResource(R.xml.preferences);
    }

    /**
     * Wraps {@link #onCreate(Bundle)} code for Android >= 3 (i.e. API lvl >=
     * 11).
     */
    @TargetApi(Build.VERSION_CODES.HONEYCOMB)
    private void onCreatePreferenceFragment() {
        getFragmentManager().beginTransaction()
                .replace(android.R.id.content, new MyPreferenceFragment ())
                .commit();
    }
}

Для "реального" (але більш складного) прикладу див. NusicPreferencesActivity та NusicPreferencesFragment .

Замість винятків просто використовуйте:

if (Build.VERSION.SDK_INT >= 11)

і використовувати

@SuppressLint("NewApi")

для придушення попереджень.

Замість того, PreferenceActivityщоб безпосередньо використовувати налаштування, використовуйте AppCompatActivityабо еквівалент, який завантажуєPreferenceFragmentCompat те, що завантажує ваші налаштування. Це частина бібліотеки підтримки (зараз Android Jetpack) і забезпечує сумісність назад до API 14.

У ваших build.gradle, додати залежність для бібліотеки підтримки переваги:

dependencies {
    // ...
    implementation "androidx.preference:preference:1.0.0-alpha1"
}

Примітка. Ми припустимо, що у вас уже створені ваші налаштування XML.

Для своєї діяльності створіть новий клас активності. Якщо ви використовуєте матеріальні теми, вам слід розширити AppCompatActivity, але ви можете бути гнучкими в цьому:

public class MyPreferencesActivity extends AppCompatActivity {

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.my_preferences_activity)
        if (savedInstanceState == null) {
            getSupportFragmentManager().beginTransaction()
                    .replace(R.id.fragment_container, MyPreferencesFragment())
                    .commitNow()
        }
    }
}

Тепер про важливу частину: створіть фрагмент, який завантажує ваші налаштування з XML:

public class MyPreferencesFragment extends PreferenceFragmentCompat {

    @Override
    public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
        setPreferencesFromResource(R.xml.my_preferences_fragment); // Your preferences fragment
    }
}

Для отримання додаткової інформації читайте документи для розробників Android для PreferenceFragmentCompat.