Android. Программирование для профессионалов. 4-е издание

20sp
3dp
name="AppTheme"
parent="
Theme.AppCompat.Light.DarkActionBar
">
name="colorPrimary">@color/colorPrimary
name="colorPrimaryDark">@color/colorPrimaryDark

name="colorAccent">@color/colorAccent
).addMigrations(migration_1_2)
.build()
private val crimeDao = database.crimeDao()
...
}
Чтобы настроить миграцию, перед вызовом функции
build()
вызывается функция 
addMigrations(...)
. Функция
addMigrations()
принимает 
переменное 
количество
объектов 
Migration
, так что вы можете передать все свои
миграции в момент объявления.
Когда ваше приложение запустится и Room соберет базу
данных, оно сначала проверит версию существующей базы
данных на устройстве. Если эта версия не соответствует той,
которую вы определили в аннотации к базе данных 
@Database
,
Room будет искать соответствующие миграции, чтобы обновить
базу данных до последней версии.
Миграция важна для преобразования вашей базы данных.
Если вы не укажете миграцию, Room удалит старую версию
базы данных и создаст новую версию. Это означает, что все
данные будут потеряны, а это приведет к недовольству
пользователей.
После того как вы реализовали миграцию, запустите
CriminalIntent, чтобы удостовериться, что все построено
правильно. Поведение приложения должно быть таким же, как
и до того, как вы применили миграцию, и вы увидите
добавленное преступление, как в главе 14. Вскоре мы
воспользуемся добавленным столбцом.
Форматные строки

---

Последним подготовительным шагом станет создание шаблона
отчета о преступлении, который заполняется информацией о
конкретном преступлении. Так как подробная информация
недоступна до стадии выполнения, необходимо использовать
форматную строку с заполнителями, которые будут заменяться
во время выполнения. Форматная строка будет выглядеть так:
%1$s! The crime was discovered on %2$s. %3$s,
and %4$s
Поля 
%1$s
, 
%2$s
и т.д. — заполнители для строковых
аргументов. В коде вы вызываете функцию 
getString(...)
и
передаете форматную строку и еще четыре строки в том
порядке, в каком они должны заменять заполнители.
Сначала добавьте в файл 
strings.xml
строки из листинга
15.6.