Карточный домик - Инструкции

В этом разделе собраны инструкции и практические руководства по установке и настройке приложения Карточный домик (Card House). Здесь вы найдёте пошаговое описание процесса инсталляции, рекомендации по быстрому старту и первичной конфигурации. Также приведены материалы по добавлению и управлению карточками, настройке лицензии и основным рабочим сценариям. Документация ориентирована как на новых пользователей, так и на тех, кто хочет глубже разобраться в возможностях приложения.

Установка

Если вы устанавливаете приложение не из магазинов приложений (RuStore, Uptodown, ...) и делаете это впервые, то система Android может предложить вам провести проверку приложения средствами Google. На следующем рисунке показан пример такой рекомендации.

Рис.1. Запрос на проверку APK.

Мы настоятельно советуем не игнорировать данную проверку. Это позволит убедиться в том, что приложение не содержит никаких угроз для вашего смартфона:

Рис.2. Проверка пройдена.

После прохождения всех необходимых проверок, Google Play защита предложит установить приложение Карточный домик (Card House).

Далее последует предупреждение о возможных рисках. Дело в том, что для работы с карточками магазинов приложению необходим доступ к камере. Google считает это чувствительным разрешением и, естественно, сообщает вам об этом.

Рис.3. Предупреждение о возможных рисках.

Здесь вы можете нажать кнопку «Включить» или более подробно ознакомиться с предоставляемой информацией. На процесс установки ваши действия уже никак не повлияют.

Мы не случайно заостряем ваше внимание на вопросах безопасности. В современном мире безопасность имеет большое значение и тут самое время, дополнительно, упомянуть о том, что приложение Карточный домик (Card House) разрабатывалось таким образом, чтобы ни в коем случае не переступать пределы дозволенного. Так, например, приложение запрашивает у вас только самые необходимые разрешения на доступ к файлам и камере. Первое разрешение, необходимо для того, чтобы вы могли сохранять собственный архив карточек там, где вам удобно, будь то внутренний носитель (Internal Storage) или внешняя SD‑карта. Второе разрешение, – доступ к камере, нобходимо для сканирования штрих‑ и QR‑кодов ваших карт.

Приложение не имеет доступа к вашей галерее. И мы осознанно не пытаемся получить данное разрешение, хотя это могло быть полезным для сканирования штрих‑ и QR‑кодов с фотографий, а также для получения изображений ваших карт. Но личный фотоархив – дело неприкосновенное, и не всем пользователям захочется допускать к нему сторонние приложения.

Начало работы

Основная задача приложения Карточный домик (Card House) – это управление пользовательскими архивами бонусных или скидочных карт магазинов. Архивами, по сути, являются SQLite3 базы данных, в которых содержатся изображения, специальные коды и другие, идентифицирующие карту, данные. Если приложение не владеет ни одним архивом, либо передоставленный ему архив пуст, то смысла продолжать работу у приложения просто нет.

Потому в начале работы, после первичного запуска, приложение обозначает две контрольные точки. Первая – служит для напоминания о необходимости создания новой или выбора существующей базы данны, а вторая контрольная точка необходима в том случае, если база оказывается пустой.

Мы решили сделать эти контрольные точки максимально информативными, чтобы не отсылать пользователя к скучной документации, а сразу предоставить ему все необходимые пояснения для начала работы.

Создание или выбор базы данных

Первая контрольная точка представлена на рис.4. При первичном запуске, когда пользователь еще не предоставлял никаких прав приложению, единственным каталогом, в файловой системе внутренного накопителя смартфона, где разрешено создавать файлы, является каталог загрузок. Как правило это каталог /Download в корне файловой системы. Поэтому приложение Карточный домик (Card House), не дожидаясь разрешения пользователя, создает каталог /Download/CardHouse.

Рис.4. Приглашение к созданию архива карт.

Каталог /Download/CardHouse становится, своего рода, домашним каталогом приложения, но не в закрытой от пользователя области, а в общедоступном пространстве. Таким образом, пользователь получает возможность просматривать содержимое этого каталога любым файловым менеджером, а не только с помощью приложения Карточный домик (Card House). Другими словами, система Android позволяет приложению Карточный домик (Card House) хранить файлы в каталоге /Download, без получения специальных разрешений от пользователя.

Это общая практика для системы Android. Вы наверняка видели, например, каталог /Download/Telegram на своем устройстве. Также в каталоге /Download хранят свои файлы такие приложения, как Госуслуги, Строительный торговый дом «Петрович» и многие другие.

Отсюда, на первой контрольной точке, и вытекает рекомендация создавать первую базу именно в каталоге /Download/CardHouse. А вот уже после того, как пользователь предоставит права на все файлы приложению Карточный домик (Card House), он сможет управлять своими архивами карт в любом другом каталоге, будь то внутренний накопитель (Internal Storage) или SD-карта.

Итак, большая красная кнопка в углу экрана (рис.4) ведет пользователя в раздел «Настройки», показанный на следующем рисунке.

Рис.5. Настройки. Файл базы данных.

Как видно на рис.4, файл базы данных еще не создан. Если пользователь еще не предоставлял приложению права на работу с файлами, то после нажатия на карточку «Файл базы данных» ему будет сделано предупреждение о том, что такие права всеже необходимы приложению (рис.6).

Рис.6. Предупреждение о необходимости предоставления прав.

Здесь, пользователь может просто согласиться, а уже непосредственно принимать решение о предоставлении прав он будет в рамках следующего системного диалога (рис.7).

Рис.7. Предоставление прав доступа к файлам.

По выходу из системного диалога, пользователь повторно нажимает на карточку «Файл базы данных».

Здесь, он может, либо создать новый файл базы данных, либо выбрать уже существующий файл, причем в любом каталоге и на любом носителе информации, поскольку разрешения уже предоставлены и приложение Карточный домик (Card House) не имеет препятствий для поиска файлов.

Рис.8. Выбор существующего архива или создание нового.

Разумеется, если у пользователя еще нет архива карт, необходимо выбрать кнопку «Создать файл».

Как мы говорили ранее, каталогом по умолчанию является каталог /Download/CardHouse. Поэтому приложение вызовет системный диалог создания файла (рис.9) с именем файла cards.db в каталоге /Download/CardHouse.

Рис.9. Системный файловый менеджер.

Если у пользователя нет возражений, ему останется лишь нажать на кнопку «СОХРАНИТЬ» (в правом нижнем углу экрана). Однако это не мешает пользователю выбрать другое имя файла или сменить каталог назначения.

Раз уж мы заговорили о системных диалогах, таких как "Save To" и "Open From", надо сказать пару слов об управлении файлами на системе Android.

Приложение Карточный домик (Card House) не является полноценным файловым менеджером, для открытия и создания файлов баз данныx ему достаточно обычных, стандартных диалогов, которые предоставляет Android. Поэтому внешний вид таких диалогов будет зависеть от системы и не всегда будет соответствовать дизайну самого приложения.

Рис.10. Настройки. Текущий архив.

Итак, мы имеем, только что созданный, файл /Download/CardHouse/cards.db. Разумеется, он пуст и теперь мы можем приступать к его наполнению бонусными и скидочными картами, которых накопилось не мало.

Добавление первой карты

Мы находимся во второй контрольной точке, о которых мы говорили ранее. База пуста, и об этом предупреждает пользователя следующее окно (рис.11).

Рис.11. Приглашение к добавлению в архив первой карты.

Данная анимация дает практически полное представление о том, что добавление новой карты в архив очень простая процедура. Надо лишь отсканировать штрих‑ или QR‑код и новая карта мгновенно окажется в базе.

Именно так все и происходит. При нажатии на кнопку внизу экрана, пользователь получает список карт магазинов (рис.12) и удобное средство поиска. Если же карты в списке не окажется, то пользователю предлагается выбрать пункт «Другая карта», где он сможет, после сканирования кода карты, задать название, краткое описание карты, а также сфотографировать как саму карту, так и логотип магазина, чтобы эту карту было легко находить среди других карт по ее изображению.

Рис.12. Поиск и выбор магазина.

По мере ввода букв в поле поиска, список карт прокручивается к найденной карте. Как только найдена нужная карта, выбрать ее можно нажав на элемент списка или на любую кнопку с изображением лупы, как внизу виртуальной клавиатуры, так и справа в самом поле ввода.

Если пользователь еще не предоставил приложению Карточный домик (Card House) прав на использование камеры, то, после выбора нужной карты, изображение в объективе камеры будет заблокировано и будет необходимо выбрать, на какой срок предоставить права (рис.13).

Рис.13. Предоставление разрешения на работу камеры смартфона.

Разумеется, мы рекомендуем предоставить права на время, когда используется само приложение. Этого вполне достаточно, чтобы данный вопрос более не возникал.

Для запуска процесса сканирования кода карты надо нажать на кнопку с изображением камеры, под объективом (рис.14).

Рис.14. Начало сканирования.

Как только сканер распознает код, под объективом появится изображение полученного кода, а также версия. Например, на следующем изображении (рис.15) показан QR‑код версии 8 и методом коррекции ошибок Q.

Рис.15. Результат сканирования.

Данные, представленные кодом, не всегда совпадают с номером карты, особенно это касается QR‑кодов по тому, что QR‑код может содержать значительный объем инфтрмации, в отличие от штрих‑кодов. Поэтому мы в принципе отказались от ручного ввода номера карты, так как это может ввести пользователя в заблуждение. Сейчас многие магазины переходят на QR‑код, так что сам по себе номер карты уже не несет в себе никакой полезной информации.

Для того чтобы сохранить карту в базе данных, необходимо нажать и удерживать полученный рисунок кода. После этого приложение перейдет на главный экран, где представлены все карты текущего архива (рис.16).

Рис.16. Таблица пользовательских карт.

Карты, на главном экране, располагаются в две колонки. Здесь, для представления карт используются стилизованные изображения карт. Фотографии лицевой стороны карты предназначены для карусели часто используемых карт. Включить показ карусели можно в меню »Настройки», а в свойствах самой карты можно указать, надо ее показывать в карусели или нет (рис.17).

Чтобы предъявить карту в магазине, пользователю нужно просто кликнуть по карте.

Рис.17. Предъявление карты на кассе магазина.

Экран здесь поделен на две части. Верхняя содержит код карты для сканирования на кассе магазине, а нижняя предназначена для показа свойств самой карты. Важно, что при прокрутке содержимого нижней части экрана, верхняя часть всегда находится на переднем плане. Это сделано для того, чтобы даже случайные движения пальцами по экрану не могли помешать процессу сканирования. Кроме того, в этом режиме, запрещен поворот экрана. Это особенно важно в суетливой обстановке у кассы магазина.

Мы уже говорили ранее, что приложение Карточный домик (Card House) не является файловым менеджером. Однако вам ничто не мешает перемещать и копировать свои архивы карт в любой каталог и на любой носитель информации посредством любого файлового менеджера, который установлен на вашем смартфоне.

На рис.18 показан интерфейс приложения «Google Files», с помошью которого вы можете управлять местоположением ваших архивов. Данный менеджер файлов позволит вам сделать резервную копию архива даже в облачном хранилище, например, Яндекс Диск, Google Disk, Nextcloud и так далее.

Рис.18. Расположение архива по умолчанию.

Файл с расширением .db-journal вам не нужен. Вся информация находится в файле с расширением .db, а журнал SQLite обычно пуст, так как все транзакции по добавлению карт проходят синхронно и моментально.

Приобретение лицензии

Приложение Карточный домик (Card House), по умолчанию, не требует от вас приобретения прав на расширенные возможности. После установки приложение работает в обычном режиме и вы можете создавать неограниченное число архивов ваших карт. Но ограничения все же есть: вы не можете добавить в один и тот же архив более трех карт. Как только вы попытаетесь добавить четвертую карту, на экране появится предупреждение (рис.19).

Рис.19. Предупреждение об ограничениях.

Если вы нажмете на кнопку «OK», вы будете перенаправлены на страницу «Покупки».

Сразу после приобретения лицензии, ограничение будет снято и вы сможете создавать архивы неограниченного объема. При этом, вам не нужно проходить никакой регистрации. Лицензия привязывается к вашему телефону по его Идентификатору, который вы можете видеть в меню «Настройки», показанном на рис.10. Кнопки «Регистрация» или «Вход» нужны лишь для того случая, если вы захотите управлять вашими лицензиями или просто посмотреть информацию о приобретенных лицензиях и устройствах, к которым они привязаны.

Одна лицензия выдается на неограниченный срок и может быть привязана не более чем к трем устройствам. Отвязать лицензию от устройства нельзя, так что не торопитесь использовать все «три желания» сразу. Они вам могут пригодиться позднее, например, при покупке нового телефона.

Уникальный «Идентификатор устройства» (рис.10) остается неизменным до тех пор, пока на телефоне не будет сделан сброс к заводским настройкам. При удалении приложения и повторной его установке, «Идентификатор устройства» не изменяется.

По поводу страницы «Покупки», важно обратить внимание на следующее.

Когда вы заходите на эту страницу из приложения Карточный домик (Card House) по приглашению (рис.19), ваш «Идентификатор устройства» передается автоматически. Но, если вы заходите на эту страницу из браузера, то после нажатия на кнопку «Приобрести», вам будет предложено ввести «Идентификатор устройства» и его имя (в качестве необязательного параметра). Будьте внимательны, такая возможность вам предоставляется на тот случай, если вы захотите подарить лицензию другу и точно знаете Идентификатор его телефона.