¿Qué usar en lugar de "addPreferencesFromResource" en una PreferenceActivity?

Acabo de notar el hecho de que el método addPreferencesFromResource(int preferencesResId)está marcado como obsoleto en la documentación de Android ( Entrada de referencia ).

Desafortunadamente, no se proporciona ningún método alternativo en la descripción del método.

¿Qué método se debe utilizar en su lugar para conectar un PreferScreen.xml a la PreferenceActivity correspondiente?

No se proporciona ningún método alternativo en la descripción del método porque el enfoque preferido (a partir del nivel 11 de API) es instanciar objetos PreferenceFragment para cargar sus preferencias desde un archivo de recursos. Vea el código de muestra aquí: PreferenceActivity

Para agregar más información a la respuesta correcta anterior, después de leer un ejemplo de Android-er descubrí que puede convertir fácilmente su actividad de preferencia en un fragmento de preferencia. Si tienes la siguiente actividad:

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

Los únicos cambios que tiene que hacer es crear una clase de fragmento interno, moverlo addPreferencesFromResources()al fragmento e invocar el fragmento de la actividad, de esta manera:

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

Puede haber otras sutilezas para hacer preferencias más complejas a partir de fragmentos; si es así, espero que alguien los note aquí.

@Garret Wilson ¡Muchas gracias! Como novato en la codificación de Android, he estado atrapado con el problema de incompatibilidad de preferencias durante tantas horas, y me parece tan decepcionante que desaprobaron el uso de algunos métodos / enfoques para los nuevos que no son compatibles con las API más antiguas. tener que recurrir a todo tipo de soluciones para que su aplicación funcione en una amplia gama de dispositivos. ¡Es realmente frustrante!

Su clase es excelente, ya que le permite seguir trabajando en nuevas API con preferencias de la forma en que solía ser, pero no es compatible con versiones anteriores. Como estoy tratando de llegar a una amplia gama de dispositivos, trabajé un poco para que funcione en dispositivos anteriores a API 11, así como en API más nuevas:

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

Probado en dos emuladores (2.2 y 4.2) con éxito.

Por qué mi código se ve tan malo:

Soy un novato en la codificación de Android, y no soy el mejor fanático de Java.

Para evitar la advertencia obsoleta y forzar a Eclipse a permitirme compilar, tuve que recurrir a anotaciones, pero estas parecen afectar solo las clases o los métodos, por lo que tuve que mover el código a dos métodos nuevos para aprovechar esto.

No me gustaría tener que escribir mi ID de recurso xml dos veces cada vez que copio y pego la clase para una nueva PreferenceActivity, por lo que creé una nueva variable para almacenar este valor.

Espero que esto sea útil para alguien más.

PD: Perdón por mis opiniones obstinadas, pero cuando vienes nuevo y encuentras tales desventajas, ¡no puedes evitar frustrarte!

Mi enfoque es muy cercano al de Garret Wilson (gracias, te voté;)

Además, ofrece compatibilidad con Android <3.

Acabo de reconocer que mi solución está aún más cerca de la de Kevin Remo . Es solo un poquito más limpio (ya que no se basa en el antipatrón "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();
    }
}

Para un ejemplo "real" (pero más complejo) vea NusicPreferencesActivity y NusicPreferencesFragment .

En lugar de excepciones, solo use:

if (Build.VERSION.SDK_INT >= 11)

y use

@SuppressLint("NewApi")

para suprimir las advertencias.

En lugar de usar un PreferenceActivitypara cargar directamente las preferencias, use un AppCompatActivityo equivalente que cargue un PreferenceFragmentCompatque cargue sus preferencias. Es parte de la biblioteca de soporte (ahora Android Jetpack) y proporciona compatibilidad con API 14.

En su build.gradle, agregue una dependencia para la biblioteca de soporte de preferencias:

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

Nota: Vamos a suponer que ya tiene sus preferencias XML creadas.

Para su actividad, cree una nueva clase de actividad. Si está utilizando temas materiales, debe extender un AppCompatActivity, pero puede ser flexible con esto:

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

Ahora para la parte importante: cree un fragmento que cargue sus preferencias desde XML:

public class MyPreferencesFragment extends PreferenceFragmentCompat {

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

Para obtener más información, lea los documentos para desarrolladores de Android PreferenceFragmentCompat.