Manipulador de estado do gerenciador de fragmentos

Importante

Este artigo descreve funcionalidades e diretrizes que estão em versão prévia pública e podem ser modificadas substancialmente antes de passarem para a disponibilidade geral. A Microsoft não faz nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.

O FragmentManagerStateHandler é uma classe que ajuda a restaurar fragmentos quando ocorre uma transição em um modo de tela.

Quando movemos o aplicativo da tela dupla para o modo de tela única, todos os fragmentos são recriados mesmo que não sejam visíveis.

Usando essa biblioteca, somente o fragmento necessário será recriado.

Como os fragmentos são restaurados do pacote de atividades, podemos ter dois pacotes que são trocados em runtime, dependendo do modo de intervalo. Portanto, um pacote para a tela única e outro para o modo de intervalo. Isso só é possível adicionando um retorno de chamada do ciclo de vida de atividade e trocando esses dois pacotes dentro do retorno de chamada onActivityPreCreated.

O componente detectará automaticamente o modo de tela atual e vai restaurar somente os fragmentos necessários, de acordo com o modo de tela.

Importante

O componente funciona somente com atividades do AndroidX.

Como usar

Kotlin

class SampleApp : Application() {
    override fun onCreate() {
        super.onCreate()
        FragmentManagerStateHandler.init(this)
    }
}

class SampleActivity : AppCompatActivity() {
    companion object {
        private const val FRAGMENT_DUAL_START = "FragmentDualStart"
        private const val FRAGMENT_DUAL_END = "FragmentDualEnd"
        private const val FRAGMENT_SINGLE_SCREEN = "FragmentSingleScreen"
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_sample)
        registerWindowInfoFlow()
    }

    private fun registerWindowInfoFlow() {
        val windowInfoRepository = windowInfoRepository()
        lifecycleScope.launch(Dispatchers.Main) {
            lifecycle.repeatOnLifecycle(Lifecycle.State.STARTED) {
                windowInfoRepository.windowLayoutInfo.collectIndexed { index, info ->
                    if (index == 0) {
                        onScreenInfoChanged(info)
                    }
                }
            }
        }
    }

    /**
     * Called whenever the screen info was changed.
     * @param windowLayoutInfo object used to retrieve screen information
     */
    private fun onScreenInfoChanged(windowLayoutInfo: WindowLayoutInfo) {
        when {
            windowLayoutInfo.isInDualMode() -> setupDualScreenFragments()
            else -> setupSingleScreenFragments()
        }
    }

    /**
     * Adds fragments for the single screen mode
     */
    private fun setupSingleScreenFragments() {
        if (supportFragmentManager.findFragmentByTag(FRAGMENT_SINGLE_SCREEN) == null) {
            supportFragmentManager.inTransaction {
                replace(R.id.first_container_id, SingleScreenFragment(), FRAGMENT_SINGLE_SCREEN)
            }
        }
    }

    /**
     * Adds fragments for the dual screen mode
     */
    private fun setupDualScreenFragments() {
        if (supportFragmentManager.findFragmentByTag(FRAGMENT_DUAL_START) == null &&
            supportFragmentManager.findFragmentByTag(FRAGMENT_DUAL_END) == null
        ) {
            supportFragmentManager.inTransaction {
                replace(R.id.first_container_id, DualStartFragment(), FRAGMENT_DUAL_START)
            }

            supportFragmentManager.inTransaction {
                replace(R.id.second_container_id, DualEndFragment(), FRAGMENT_DUAL_END)
            }
        }
    }
}

inline fun FragmentManager.inTransaction(func: FragmentTransaction.() -> Unit) {
    val fragmentTransaction = beginTransaction()
    fragmentTransaction.func()
    fragmentTransaction.commit()
}

Java

public class SampleApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        FragmentManagerStateHandler.init(this);
    }
}

public class SampleActivity2 extends AppCompatActivity {
    private static final String FRAGMENT_DUAL_START = "FragmentDualStart";
    private static final String FRAGMENT_DUAL_END = "FragmentDualEnd";
    private static final String FRAGMENT_SINGLE_SCREEN = "FragmentSingleScreen";

    private WindowInfoRepositoryCallbackAdapter adapter;
    private Consumer<WindowLayoutInfo> consumerWindowLayoutInfo;
    private Executor runOnUiThreadExecutor;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_sample);
        initWindowLayoutInfo();
    }

    private void initWindowLayoutInfo() {
        WindowInfoRepository windowInfoRepository = WindowInfoRepository.Companion.getOrCreate(this);
        adapter = new WindowInfoRepositoryCallbackAdapter(windowInfoRepository);
        runOnUiThreadExecutor = command -> {
            if (command != null) {
                new Handler(Looper.getMainLooper()).post(command);
            }
        };
        consumerWindowLayoutInfo = this::onScreenInfoChanged;
    }

    @Override
    protected void onStart() {
        super.onStart();
        adapter.addWindowLayoutInfoListener(runOnUiThreadExecutor, consumerWindowLayoutInfo);
    }

    @Override
    protected void onStop() {
        super.onStop();
        adapter.removeWindowLayoutInfoListener(consumerWindowLayoutInfo);
    }

    /**
     * Called whenever the screen info was changed.
     *
     * @param windowLayoutInfo object used to retrieve screen information
     */
    private void onScreenInfoChanged(@NotNull WindowLayoutInfo windowLayoutInfo) {
        if (WindowLayoutInfoExtensionsKt.isInDualMode(windowLayoutInfo)) {
            setupDualScreenFragments();
        } else {
            setupSingleScreenFragments();
        }
    }

    /**
     * Adds fragments for the single screen mode
     */
    private void setupSingleScreenFragments() {
        FragmentManager fragmentManager = getSupportFragmentManager();
        if (fragmentManager.findFragmentByTag(FRAGMENT_SINGLE_SCREEN) == null) {
            fragmentManager
                    .beginTransaction()
                    .replace(R.id.first_container_id, new SingleScreenFragment(), FRAGMENT_SINGLE_SCREEN)
                    .commit();
        }
    }

    /**
     * Adds fragments for the dual screen mode
     */
    private void setupDualScreenFragments() {
        FragmentManager fragmentManager = getSupportFragmentManager();
        if (fragmentManager.findFragmentByTag(FRAGMENT_DUAL_START) == null &&
                fragmentManager.findFragmentByTag(FRAGMENT_DUAL_END) == null) {
            fragmentManager
                    .beginTransaction()
                    .replace(R.id.first_container_id, new DualStartFragment(), FRAGMENT_DUAL_START)
                    .commit();
            fragmentManager
                    .beginTransaction()
                    .replace(R.id.second_container_id, new DualEndFragment(), FRAGMENT_DUAL_END)
                    .commit();
        }
    }
}