Que faut-il utiliser au lieu de «addPreferencesFromResource» dans une PreferenceActivity?

Je viens de remarquer le fait que la méthode addPreferencesFromResource(int preferencesResId)est marquée comme obsolète dans la documentation d'Android ( Reference Entry ).

Malheureusement, aucune méthode alternative n'est fournie dans la description de la méthode.

Quelle méthode doit être utilisée à la place afin de connecter un preferenceScreen.xml à la PreferenceActivity correspondante?

Aucune méthode alternative n'est fournie dans la description de la méthode car l'approche préférée (à partir de l'API niveau 11) consiste à instancier des objets PreferenceFragment pour charger vos préférences à partir d'un fichier de ressources. Voir l'exemple de code ici: PreferenceActivity

Pour ajouter plus d'informations à la bonne réponse ci-dessus, après avoir lu un exemple d'Android-er, j'ai trouvé que vous pouvez facilement convertir votre activité de préférence en un fragment de préférence. Si vous avez l'activité suivante:

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

Les seules modifications que vous devez apporter sont de créer une classe de fragment interne, de déplacer le addPreferencesFromResources()dans le fragment et d'appeler le fragment de l'activité, comme ceci:

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

Il peut y avoir d'autres subtilités à faire des préférences plus complexes à partir de fragments; si c'est le cas, j'espère que quelqu'un les note ici.

@Garret Wilson Merci beaucoup! En tant que noob au codage Android, je suis coincé avec le problème d'incompatibilité des préférences depuis tant d'heures, et je trouve tellement décevant qu'ils aient déconseillé l'utilisation de certaines méthodes / approches pour les nouvelles qui ne sont pas prises en charge par les anciennes API. avoir à recourir à toutes sortes de solutions de contournement pour faire fonctionner votre application dans une large gamme d'appareils. C'est vraiment frustrant!

Votre classe est géniale, car elle vous permet de continuer à travailler dans de nouvelles API avec des préférences comme c'était le cas auparavant, mais elle n'est pas rétrocompatible. Étant donné que j'essaie d'atteindre un large éventail d'appareils, je l'ai légèrement modifié pour le faire fonctionner dans les appareils pré-API 11 ainsi que dans les API plus récentes:

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

Testé avec succès dans deux émulateurs (2.2 et 4.2).

Pourquoi mon code a l'air si merdique:

Je suis un fan du codage Android et je ne suis pas le plus grand fan de Java.

Afin d'éviter l'avertissement obsolète et de forcer Eclipse à me permettre de compiler, j'ai dû recourir à des annotations, mais celles-ci semblent n'affecter que les classes ou les méthodes, j'ai donc dû déplacer le code sur deux nouvelles méthodes pour en tirer parti.

Je ne voudrais pas avoir à écrire mon identifiant de ressource xml deux fois à chaque fois que je copie et colle la classe pour une nouvelle PreferenceActivity, j'ai donc créé une nouvelle variable pour stocker cette valeur.

J'espère que cela sera utile à quelqu'un d'autre.

PS: Désolé pour mes opinions, mais quand vous venez de découvrir de nouveaux handicaps, vous ne pouvez pas vous empêcher de vous frustrer!

Mon approche est très proche de celle de Garret Wilson (merci, je vous ai voté;)

De plus, il offre une compatibilité descendante avec Android <3.

Je viens de reconnaître que ma solution est encore plus proche de celle de Kevin Remo . C'est juste un tout petit peu plus propre (car il ne repose pas sur l' anti-motif "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();
    }
}

Pour un exemple "réel" (mais plus complexe), voir NusicPreferencesActivity et NusicPreferencesFragment .

Au lieu d'exceptions, utilisez simplement:

if (Build.VERSION.SDK_INT >= 11)

et utilise

@SuppressLint("NewApi")

pour supprimer les avertissements.

Au lieu d'utiliser un PreferenceActivitypour charger directement les préférences, utilisez un AppCompatActivityou équivalent qui charge unPreferenceFragmentCompat qui charge vos préférences. Il fait partie de la bibliothèque de support (maintenant Android Jetpack) et offre une compatibilité avec API 14.

Dans votre build.gradle, ajoutez une dépendance pour la bibliothèque de prise en charge des préférences:

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

Remarque: nous allons supposer que vos préférences XML sont déjà créées.

Pour votre activité, créez une nouvelle classe d'activités. Si vous utilisez des thèmes matériels, vous devez étendre un AppCompatActivity, mais vous pouvez être flexible avec ceci:

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

Maintenant, pour la partie importante: créez un fragment qui charge vos préférences à partir de XML:

public class MyPreferencesFragment extends PreferenceFragmentCompat {

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

Pour plus d'informations, lisez les documents des développeurs Android pour PreferenceFragmentCompat.