savedInstanceState
é um parâmetro do método onCreate() que recebe um argumento do tipo Bundle.
Ele é usado pelo sistema para, ao recriar uma Activity, permitir restaurar o estado que ela tinha na altura em que foi destruída, por exemplo, devido ao usuário ter rodado o dispositivo.
Entenda-se que estado aqui apenas se refere ao conteúdo das views do layout da Activity, ou seja, o sistema apenas guarda automaticamente o estado do layout.
Qualquer outro tipo de informação que a Activity tenha será perdida, a não ser que seja explicitamente guardada nesse Bundle.
Para esse efeito a Activity disponibiliza o método onSaveInstanceState() que é chamado antes da Activity poder vir a ser destruída. O sistema passa a ele o objecto Bundle que mais tarde é recuperado no método onCreate()
quando a Activity for recriada, permitindo que seja guardada e depois recuperada outro tipo de informação.
Exemplo da documentação onde se guarda o valor das variáveis mCurrentScore
e mCurrentLevel
:
static final String STATE_SCORE = "playerScore";
static final String STATE_LEVEL = "playerLevel";
...
@Override
public void onSaveInstanceState(Bundle savedInstanceState) {
// Save the user's current game state
savedInstanceState.putInt(STATE_SCORE, mCurrentScore);
savedInstanceState.putInt(STATE_LEVEL, mCurrentLevel);
// Always call the superclass so it can save the view hierarchy state
super.onSaveInstanceState(savedInstanceState);
}
que depois são recuperadas no onCreate()
, se a Activity tiver sido recriada:
...
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); // Always call the superclass first
// Check whether we're recreating a previously destroyed instance
if (savedInstanceState != null) {
// Restore value of members from saved state
mCurrentScore = savedInstanceState.getInt(STATE_SCORE);
mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL);
} else {
// Probably initialize members with default values for a new instance
}
...
}
No exemplo de código que colocou na pergunta o savedInstanceState
apenas está a ser utilizado para verificar se o onCreate()
está a ser chamado devido a uma recriação da Activity ou não.
Se savedInstanceState == null
é porque a Activity está a ser criada pela primeira vez, nesse caso é criado o PlaceholderFragment e colocado no R.id.container
.