Освой Android играючи
/* Моя кошка замечательно разбирается в программировании. Стоит мне объяснить проблему ей - и все становится ясно. */
John Robbins, Debugging Applications, Microsoft Press, 2000
Методы
Метод addContentView()
Метод findViewById()
Метод finish()
Метод getFragmentManager()
Метод getParentActivityIntent()
Метод onActivityResult()
Метод onBackPressed()
Метод onConfigurationChanged()
Метод onKeyShortcut()
Метод onPostCreate()
Метод onRestoreInstanceState()
Метод onSaveInstanceState()
Метод overridePendingTransition()
Метод onUserLeaveHint()
Метод onWindowFocusChanged()
Метод requestWindowFeature()
Метод setContentView()
Метод setFeatureDrawableResource()
Метод setRequestedOrientation()
Метод startActivity()
Метод startActivityForResult()
Метод setResult()
В статье приведены только часть методов. Остальные изучайте самостоятельно через документацию.
При переходе активности от одного состояния к другому, она получает уведомления через защищенные методы:
Из перечисленных методов в вашем классе обязательно должен быть метод onCreate(), которая задаёт начальную установку параметров при инициализации активности. Вторым по популярности является метод onPause(), используемый для сохранения пользовательских настроек активности и подготовиться к прекращению взаимодействия с пользователем.
При реализации любого из этих методов необходимо всегда сначала вызывать версию этого метода из суперкласса. Например:
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
...
}
protected void onPause()
{
super.onPause();
...
}
Семь перечисленных методов определяют весь жизненный цикл активности. Есть три вложенных цикла, которые вы можете отслеживать в классе активности:
Можно написать код с заглушками для методов внутри Активности, которые обрабатывают изменения состояний. Комментарии к каждой такой заглушке описывают действия, которые нужно учитывать при обработке этих событий.
package ru.alexanderklimov.myapplication;
import android.app.Activity;
import android.os.Bundle;
public class MyActivity extends Activity {
// Вызывается при входе в "полноценное" состояние.
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Инициализируйте Активность.
}
// Вызывается, когда метод onCreate завершил свою работу,
// и используется для восстановления состояния пользовательского
// интерфейса
@Override
public void onRestoreInstanceState(Bundle savedInstanceState) {
super.onRestoreInstanceState(savedInstanceState);
// Восстановите состояние UI из переменной savedInstanceState.
// Этот объект типа Bundle также был передан в метод onCreate.
}
// Вызывается перед тем, как Активность становится "видимой".
@Override
public void onRestart(){
super.onRestart();
// Загрузите изменения, учитывая то, что Активность
// уже стала "видимой" в рамках данного процесса.
}
// Вызывается в начале "видимого" состояния.
@Override
public void onStart(){
super.onStart();
// Примените к UI все необходимые изменения, так как
// Активность теперь видна на экране.
}
// Вызывается в начале "активного" состояния.
@Override
public void onResume(){
super.onResume();
// Возобновите все приостановленные обновления UI,
// потоки или процессы, которые были "заморожены",
// когда данный объект был неактивным.
}
// Вызывается для того, чтобы сохранить пользовательский интерфейс
// перед выходом из "активного" состояния.
@Override
public void onSaveInstanceState(Bundle savedInstanceState) {
// Сохраните состояние UI в переменную savedInstanceState.
// Она будет передана в метод onCreate при закрытии и
// повторном запуске процесса.
super.onSaveInstanceState(savedInstanceState);
}
// Вызывается перед выходом из "активного" состояния
@Override
public void onPause(){
// "Замораживает" пользовательский интерфейс, потоки
// или трудоемкие процессы, которые могут не обновляться,
// пока Активность не находится на переднем плане.
super.onPause();
}
// Вызывается перед тем, как Активность перестает быть "видимой".
@Override
public void onStop(){
// "Замораживает" пользовательский интерфейс, потоки
// или операции, которые могут подождать, пока Активность
// не отображается на экране. Сохраняйте все введенные
// данные и изменения в UI так, как будто после вызова
// этого метода процесс должен быть закрыт.
super.onStop();
}
// Вызывается перед выходом из "полноценного" состояния.
@Override
public void onDestroy(){
// Очистите все ресурсы. Это касается завершения работы
// потоков, закрытия соединений с базой данных и т. д.
super.onDestroy();
}
}
Как видно из кода, переопределяя эти обработчики, вы всегда должны вызывать одноимённые методы родительского класса.
Методы жизненного цикла описаны в отдельной статье. Здесь их опишем кратко и рассмотрим другие методы.
Метод addContentView() добавляет компонент к уже существующей разметке. Пример смотрите здесь.
Метод findViewById() позволяет получить ссылку на View, которая размещена в разметке через его идентификатор.
TextView myTextView = (TextView)findViewById(R.id.tvCat);
Если вы используете фрагменты, то когда они загружаются в активность, то компоненты, входящие в состав фрагмента, становятся частью иерархии активности. И вы можете использовать метод findViewById() для получения ссылки к компоненту фрагмента.
Не путать с одноимённым методом для класса View.
C помощью метода finish() можно завершить работу активности. Если приложение состоит из одной активности, то этого делать не следует, так как система сама завершит работу приложения. Если же приложение содержит несколько активностей, между которыми нужно переключаться, то данный метод позволяет экономить ресурсы.
Каждая активность включает в себя Менеджер фрагментов для управления фрагментами, если они используются. Метод getFragmentManager() позволяет получить доступ к данному менеджеру. На сайте есть отдельные статьи, посвящённые фрагментам.
FragmentManager fragmentManager = getFragmentManager();
Возвращает намерение, которое может запускать активность, являющей родительской. Родительская активность прописывается в манифесте. Вы можете переопределить данное намерение для своих целей. Метод появился в API 16.
@TargetApi(Build.VERSION_CODES.JELLY_BEAN)
@Override
public Intent getParentActivityIntent() {
return super.getParentActivityIntent().addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
}
Дочерняя активность может произвольно возвратить назад объект Intent, содержащий любые дополнительные данные. Вся эта информация в родительской активности появляется через метод обратного вызова Activity.onActivityResult(), наряду с идентификатором, который она первоначально предоставила.
Если дочерняя активность завершится неудачно или будет закрыта пользователем без подтверждения ввода через кнопку Back, то родительская активность получит результат с кодом RESULT_CANCELED.
Метод принимает несколько параметров:
Метод, позволяющий отследить нажатине на кнопку Back. Появился в Android 2.0 (API 5). Пример использования можно посмотреть в статье Кнопка Back: Вы уверены, что хотите выйти из программы?.
Метод, который вызывается при изменении конфигурации устройства. Если в манифесте были установлены специальные параметры у атрибута android:configChanges, то данный метод не будет вызван.
Смотри Горячие клавиши в меню
Новый метод, который появился в API 21. Он вызывается позже onCreate() и в нём можно получить значения размеров компонентов, которые недоступны при построении интерфейса в методе onCreate().
Метод overridePendingTransition() позволяет задать анимацию при переходе от одной активности к другой. Пример смотрите здесь.
У метода onRestoreInstanceState() есть такой же параметр Bundle, как у onCreate(), и вы можете восстанавливать сохранённые значения из метода onSaveInstanceState(). Во многих случаях это пример личных предпочтений, какой из двух методов использовать для восстановления данных.
Метод вызывается после метода onStart(). Система вызывает метод onRestoreInstanceState() только в том случае, если имеются сохранённые данные для восстановления. Таким образом вам не нужно проверять Bundle на null, как в методе onCreate():
public void onRestoreInstanceState(Bundle savedInstanceState) {
// Always call the superclass so it can restore the view hierarchy
super.onRestoreInstanceState(savedInstanceState);
// Restore state members from saved instance
mCurrentScore = savedInstanceState.getInt(STATE_SCORE);
mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL);
}
Когда система завершает активность в принудительном порядке, чтобы освободить ресурсы для других приложений, пользователь может снова вызвать эту активность с сохранённым предыдущим состоянием. Чтобы зафиксировать состояние активности перед её уничтожением, в классе активности необходимо реализовать метод onSaveinstancestate().
Сам метод вызывается прямо перед методом onPause(). Он предоставляет возможность сохранять состояние пользовательского интерфейса активности в объект Bundle, который потом будет передаваться в методы onCreate() и onRestoreInstanceState(). В объект Bundle можно записать параметры, динамическое состояние активности как пары "ключ-значение". Когда активность будет снова вызвана, объект Bundle передаётся системой в качестве параметра в методы onCreate() и onRestoreInstanceState(), которые вызываются после onStart(), чтобы один из них или они оба могли установить активность в предыдущее состояние. Прежде чем передавать изменённый параметр Bundle в обработчик родительского класса, сохраните значения с помощью методов putXXX() и восстановите с помощью getXXX().
Используйте обработчик onSaveInstanceState() для сохранения состояния интерфейса (например, состояния флажков, текущего выделенного элемента или введённых, но не сохранённых данных), чтобы объект Activity при следующем входе в активное состояние мог вывести на экран тот же UI. Рассчитывайте, что перед завершением работы процесса во время активного состояния будут вызваны обработчики onSaveInstanceState и onPause.
В отличие от базовых методов, методы onSaveInstanceState() и onRestoreInstanceState() не относятся к методам жизненного цикла активности. Система будет вызывать их не во всех случаях. Например, Android вызывает onSaveinstancestate() прежде, чем активность становится уязвимой к уничтожению системой, но не вызывает его, когда экземпляр активности разрушается пользовательским действием (при нажатии клавиши BACK). В этом случае нет никаких причин для сохранения состояния активности.
Метод onSaveInstanceState() вызывается системой в случае изменения конфигурации устройства в процессе выполнения приложения (например, при вращении устройства пользователем или выдвижении физической клавиатуры устройства.
Поскольку метод onSaveinstanceState() вызывается не во всех случаях, его необходимо использовать только для сохранения промежуточного состояния активности. Для сохранения данных лучше использовать метод onPause().
private static final String TEXTVIEW_STATE_KEY = "TEXTVIEW_STATE_KEY";
static final String STATE_SCORE = "playerScore";
static final String STATE_LEVEL = "playerLevel";
@Override
public void onSaveInstanceState(Bundle saveInstanceState) {
// получаем ссылку на текстовую метку
TextView myTextView = (TextView)findViewById(R.id.textView);
// Сохраняем его состояние
saveInstanceState.putString(TEXTVIEW_STATE_KEY, myTextView.getText().toString());
// Сохраняем состояние игрока
savedInstanceState.putInt(STATE_SCORE, mCurrentScore);
savedInstanceState.putInt(STATE_LEVEL, mCurrentLevel);
// всегда вызывайте суперкласс для сохранения состояний видов
super.onSaveInstanceState(saveInstanceState);
}
Этот обработчик будет срабатывать всякий раз, когда жизненный цикл активности начнёт подходить к концу, но только в том случае, если её работа не будет завершена явно (при вызове метода finish()). Вследствие этого обработчик используется для проверки целостности состояния активности между активными жизненными циклами одиночной пользовательской сессии.
Сохранённый параметр Bundle передаётся методам onRestoreInstanceState() и onCreate(), если приложение принудительно перезапускается на протяжении сессии. В листинге показано, как извлечь значения из этого параметра и использовать их для обновления состояния экземпляра активности.
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
TextView myTextView = (TextView)findViewById(R.id.textView);
String text = "";
if (savedInstanceState != null && savedInstanceState.containsKey(TEXTVIEW_STATE_KEY))
text = savedInstanceState.getString(TEXTVIEW_STATE_KEY);
myTextView.setText(text);
}
Примеры использования можно увидеть в статьях Секундомер, Программное удаление пункта меню и Прячем и показываем ActionBar
В API 28 метод вызывается после метода onStop(), в ранних версиях до метода onStop().
Позволяет отследить нажатие кнопки Home
@Override
protected void onUserLeaveHint() {
Toast toast = Toast.makeText(getApplicationContext(), "Нажата кнопка HOME", Toast.LENGTH_SHORT);
toast.show();
super.onUserLeaveHint();
}
Метод позволяет задействовать дополнительные возможности для активности, например, выводить экран активности без заголовка. Примеры смотрите здесь.
Метод позволяет определить момент получения фокуса вашим приложением.
@Override
public void onWindowFocusChanged(boolean hasFocus) {
super.onWindowFocusChanged(hasFocus);
if(hasFocus)
Toast.makeText(this, "Focus", Toast.LENGTH_LONG).show();
}
Метод может быть полезен, так как он срабатывает позже метода onCreate(). Например, для вычисления размеров кнопки на экране этот метод предпочтительнее, так как уже известно, что все элементы загрузились и доступны, тогда как в onCreate() могут возвратиться пустые значения ширины и высоты кнопки. Пример использования.
Другой пример: Получить координаты компонента
Изначально экран активности пуст. Чтобы разместить пользовательский интерфейс, необходимо вызвать метод setContentView(). У метода есть две перегруженные версии. Вы можете передать в параметре либо экземпляр компонента (View), либо идентификатор ресурса (наиболее распространённый способ).
Пример с использованием экземпляра компонента:
@Override
public void onCreate(Bundle saveInstanceState) {
super.onCreate(saveInstanceState);
TextView myTextView = new TextView(this);
setContentView(myTextView);
myTextView.setText("Hello, Kitty");
}
В этом примере вы увидите на экране текстовое поле с текстом. Но при таком способе вы можете использовать только один компонент. А если экран состоит из множества кнопок и прочих элементов управления, то нужно использовать разметку.
С помощью данного метода можно вывести значки в правой части заголовка. Смотри пример.
Метод позволяет программно изменить ориентацию экрана. Пример использования.
Чтобы запустить новую активность, используется метод startActivity(Intent). Этот метод принимает единственный параметр — объект Intent, описывающий активность, которая будет запускаться. Смотри пример Activity.
Иногда требуется вернуть результат активности, когда она закрывается. Например, можно запустить активность, которая позволяет пользователю выбирать человека в списке контактов. При закрытии активность возвращает данные человека, который был выбран: его полное имя и телефон. В этом случае необходимо вызвать метод startActivityForResult()
Метод startActivityForResult(Intent, int) со вторым параметром, идентифицирующим запрос позволяет возвращать результат. Когда дочерняя активность закрывается, то в родительской активности срабатывает метод onActivityResult(int, int, Intent), который содержит возвращённый результат, определённый в родительской активности.
// идентификатор запроса
private static final int SHOW_SUBACTIVITY = 1;
Intent intent = new Intent();
// определение класса запускаемой активности
intent.setClass(this, NewContactActivity.class);
// вызов активности
startActivityForResult(intent, SHOW_SUBACTIVITY);
Когда активность завершится, вы можете вызвать метод setResult(int), чтобы возвратить данные назад в родительскую активность (до метода finish()). Этот метод возвращает код результата закрытия активности, который может быть стандартными результатами Activity.RESULT_CANCELED, Activity.RESULT_OK или определяемым пользователем результатом RESULT_FiRST_USER (можете придумать любую константу с целочисленным значением).
private EditText mName;
private EditText mPhone;
Intent intent new Intent();
// вставляем имя человека
intent.putExtra(ContactListActivity.NAME, mName.getText().toString());
// вставляем номер телефона
intent.putExtra(ContactListActivity.PHONE, mPhone.getText().toString());
// возвращаем результат в вызывающую активность
setResult(RESULT_OK, intent);
finish();
Если в дочерней активности есть кнопка отмены, то код может быть следующим:
setResult(RESULT_CANCELED);
finish();
Если метод finish() вызвать раньше метода setResult(), то результирующий код установится в RESULT_CANCELED автоматически, а возвращённое намерение покажет значение null.