Was ist anstelle von "addPreferencesFromResource" in einer PreferenceActivity zu verwenden?

Ich habe gerade festgestellt, dass die Methode in der Android-Dokumentation ( Referenzeintrag ) addPreferencesFromResource(int preferencesResId)als veraltet markiert ist .

Leider ist in der Beschreibung der Methode keine alternative Methode angegeben.

Welche Methode sollte stattdessen verwendet werden, um eine PreferenceScreen.xml mit der passenden PreferenceActivity zu verbinden?

In der Beschreibung der Methode wird keine alternative Methode angegeben, da der bevorzugte Ansatz (ab API-Ebene 11) darin besteht, PreferenceFragment- Objekte zu instanziieren , um Ihre Einstellungen aus einer Ressourcendatei zu laden. Den Beispielcode finden Sie hier: PreferenceActivity

Um der richtigen Antwort oben weitere Informationen hinzuzufügen, haben Sie nach dem Lesen eines Beispiels von Android-er festgestellt, dass Sie Ihre Präferenzaktivität einfach in ein Präferenzfragment konvertieren können. Wenn Sie die folgende Aktivität haben:

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

Die einzigen Änderungen, die Sie vornehmen müssen, sind das Erstellen einer internen Fragmentklasse, das Verschieben der addPreferencesFromResources()in das Fragment und das Aufrufen des Fragments aus der Aktivität wie folgt :

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

Es kann andere Feinheiten geben, komplexere Präferenzen aus Fragmenten zu ziehen. wenn ja, hoffe ich, dass jemand sie hier notiert.

@ Garret Wilson Vielen Dank! Als Neuling in der Android-Codierung habe ich mich so viele Stunden lang mit dem Problem der Inkompatibilität von Einstellungen beschäftigt, und ich finde es so enttäuschend, dass die Verwendung einiger Methoden / Ansätze für neue Methoden, die von den älteren APIs nicht unterstützt werden, abgelehnt wurde Sie müssen auf alle möglichen Problemumgehungen zurückgreifen, damit Ihre App auf einer Vielzahl von Geräten funktioniert. Es ist wirklich frustrierend!

Ihre Klasse ist großartig, denn Sie können weiterhin in neuen APIs mit Einstellungen arbeiten, wie sie früher waren, aber sie ist nicht abwärtskompatibel. Da ich versuche, eine breite Palette von Geräten zu erreichen, habe ich ein wenig daran herumgebastelt, damit es sowohl auf Geräten vor API 11 als auch in neueren APIs funktioniert:

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

Mit Erfolg in zwei Emulatoren (2.2 und 4.2) getestet.

Warum mein Code so beschissen aussieht:

Ich bin ein Neuling in der Android-Codierung und ich bin nicht der größte Java-Fan.

Um die veraltete Warnung zu vermeiden und Eclipse zum Kompilieren zu zwingen, musste ich auf Anmerkungen zurückgreifen, die jedoch nur Klassen oder Methoden betreffen. Daher musste ich den Code auf zwei neue Methoden verschieben, um dies zu nutzen.

Ich möchte meine XML-Ressourcen-ID nicht zweimal schreiben müssen, wenn ich die Klasse für eine neue PreferenceActivity kopiere und einfüge. Daher habe ich eine neue Variable zum Speichern dieses Werts erstellt.

Ich hoffe, dass dies jemand anderem nützlich sein wird.

PS: Entschuldigen Sie meine Meinung, aber wenn Sie neu kommen und solche Nachteile finden, können Sie nicht anders, als frustriert zu werden!

Mein Ansatz ist Garret Wilsons sehr nahe (danke, ich habe dich gewählt;)

Darüber hinaus bietet es Abwärtskompatibilität mit Android <3.

Ich habe gerade erkannt, dass meine Lösung der von Kevin Remo noch näher kommt . Es ist nur ein bisschen sauberer (da es nicht auf dem Antipattern "Erwartung" beruht ).

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

Ein "reales" (aber komplexeres) Beispiel finden Sie unter NusicPreferencesActivity und NusicPreferencesFragment .

Verwenden Sie anstelle von Ausnahmen einfach:

if (Build.VERSION.SDK_INT >= 11)

und verwenden

@SuppressLint("NewApi")

die Warnungen zu unterdrücken.

Anstatt a PreferenceActivityzum direkten Laden von Einstellungen zu verwenden, verwenden Sie ein AppCompatActivityoder ein Äquivalent, PreferenceFragmentCompatdas a lädt und Ihre Einstellungen lädt. Es ist Teil der Support-Bibliothek (jetzt Android Jetpack) und bietet Kompatibilität zurück zu API 14.

Fügen Sie in Ihrem build.gradleeine Abhängigkeit für die Bibliothek zur Unterstützung von Einstellungen hinzu:

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

Hinweis: Wir gehen davon aus, dass Sie Ihre XML-Einstellungen bereits erstellt haben.

Erstellen Sie für Ihre Aktivität eine neue Aktivitätsklasse. Wenn Sie Materialthemen verwenden, sollten Sie ein erweitern AppCompatActivity, aber Sie können damit flexibel sein:

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

Nun zum wichtigen Teil: Erstellen Sie ein Fragment, das Ihre Einstellungen aus XML lädt:

public class MyPreferencesFragment extends PreferenceFragmentCompat {

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

Weitere Informationen finden Sie in den Android Developers- Dokumenten für PreferenceFragmentCompat.