Czego używać zamiast „addPreferencesFromResource” w PreferenceActivity?

Właśnie zauważyłem fakt, że metoda addPreferencesFromResource(int preferencesResId)jest oznaczona jako przestarzała w dokumentacji Androida ( Reference Entry ).

Niestety w opisie metody nie podano żadnej alternatywnej metody.

Której metody należy użyć zamiast tego, aby połączyć plik preferenceScreen.xml z pasującą funkcją PreferenceActivity?

W opisie metody nie podano żadnej metody alternatywnej, ponieważ preferowanym podejściem (od poziomu API 11) jest tworzenie instancji obiektów PreferenceFragment w celu załadowania preferencji z pliku zasobów. Zobacz przykładowy kod tutaj: PreferenceActivity

Aby dodać więcej informacji do poprawnej odpowiedzi powyżej, po przeczytaniu przykładu z Androida-er znalazłem, że możesz łatwo przekonwertować swoją aktywność preferencyjną na fragment preferencji. Jeśli masz następujące działania:

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

Jedyne zmiany, które musisz wprowadzić, to utworzyć wewnętrzną klasę fragmentu, przenieść addPreferencesFromResources()fragment do fragmentu i wywołać fragment z działania, jak poniżej:

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);
        }
    }
}

Mogą istnieć inne subtelności w tworzeniu bardziej złożonych preferencji z fragmentów; jeśli tak, mam nadzieję, że ktoś je tutaj zauważy.

@Garret Wilson Dziękuję bardzo! Jako noob do kodowania Androida, utknąłem z problemem niezgodności preferencji przez tak wiele godzin i uważam to za tak rozczarowujące, że przestały używać niektórych metod / podejść do nowych, które nie są obsługiwane przez starsze API konieczność korzystania z różnego rodzaju obejść, aby aplikacja działała na wielu różnych urządzeniach. To naprawdę frustrujące!

Twoja klasa jest świetna, ponieważ pozwala ci pracować w nowych interfejsach API z preferencjami, tak jak kiedyś, ale nie jest kompatybilna wstecz. Ponieważ próbuję dotrzeć do szerokiej gamy urządzeń, majstrowałem przy nim trochę, aby działał na urządzeniach w wersji wcześniejszej niż API 11, a także w nowszych interfejsach 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
        }
    }
}

Testy zakończyły się powodzeniem w dwóch emulatorach (2.2 i 4.2).

Dlaczego mój kod wygląda tak kiepsko:

Nie jestem koderem Androida i nie jestem największym fanem Java.

Aby uniknąć przestarzałego ostrzeżenia i zmusić Eclipse do umożliwienia mi kompilacji, musiałem uciekać się do adnotacji, ale wydają się one wpływać tylko na klasy lub metody, więc musiałem przenieść kod na dwie nowe metody, aby z tego skorzystać.

Nie chciałbym pisać mojego identyfikatora zasobu xml dwa razy za każdym razem, gdy kopiuję i wklejam klasę dla nowej PreferenceActivity, więc utworzyłem nową zmienną do przechowywania tej wartości.

Mam nadzieję, że przyda się to komuś innemu.

PS: Przepraszam za moje opinie, ale kiedy przychodzisz nowy i odnajdujesz takie utrudnienia, nie możesz się powstrzymać od frustracji!

Moje podejście jest bardzo podobne do podejścia Garreta Wilsona (dzięki, głosowałem za;)

Ponadto zapewnia kompatybilność w dół z systemem Android <3.

Właśnie zrozumiałem, że moje rozwiązanie jest jeszcze bliższe rozwiązaniu Kevina Remo . Jest po prostu odrobinę czystszy (ponieważ nie opiera się na antipatternu „expection” ).

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();
    }
}

Dla „prawdziwego” (ale bardziej złożonego) przykładu zobacz NusicPreferencesActivity i NusicPreferencesFragment .

Zamiast wyjątków po prostu użyj:

if (Build.VERSION.SDK_INT >= 11)

I użyć

@SuppressLint("NewApi")

tłumić ostrzeżenia.

Zamiast używać a PreferenceActivitydo bezpośredniego wczytywania preferencji, użyj AppCompatActivitylub równoważnego, który ładuje aPreferenceFragmentCompat który ładuje preferencje. Jest częścią biblioteki wsparcia (obecnie Android Jetpack) i zapewnia zgodność z API 14.

W swoim build.gradledodaj zależność dla biblioteki obsługi preferencji:

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

Uwaga: założymy, że masz już utworzone preferencje XML.

Dla swojej aktywności utwórz nową klasę aktywności. Jeśli używasz motywów materiałowych, powinieneś przedłużyć AppCompatActivity, ale możesz być elastyczny dzięki temu:

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()
        }
    }
}

Teraz ważna część: utwórz fragment, który ładuje twoje preferencje z XML:

public class MyPreferencesFragment extends PreferenceFragmentCompat {

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

Aby uzyskać więcej informacji, przeczytaj dokumentację dla programistów Androida dla PreferenceFragmentCompat.