Илья Школьник

Блог iOS-разработчика

Monthly Archives: Апрель 2017

Прокачиваем Xcode: Сниппеты

Posted on by Posted in FAQ, Mac OS, Код, Проекты Leave a comment

Xcode Snippet

В этой статье я расскажу, как создавать свои сниппеты в Xcode и, собственно, расшаривать их между Маками.

Введение

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

В составе Xcode уже есть целый набор сниппетов, который можно использовать в панели Utilities / Code Snippet Library.

Xcode позволяет создавать собственные сниппеты, которые будут располагаться в следующей папке:

~/Library/Developer/Xcode/UserData/CodeSnippets

Давайте рассмотрим структуру Xcode-сниппета.

Сниппет – это plist-файл  с расширением codesnippet. Состоит как минимум из следующих ключей:

IDECodeSnippetCompletionPrefix – префикс сниппета для подсказки его в коде

IDECodeSnippetCompletionScopes – массив расположений в коде, где может использоваться подсказка сниппета: All / ClassImplementation / CodeExpression / CodeBlock / StringOrComment / TopLevel

IDECodeSnippetContents – непосредственный код сниппета

IDECodeSnippetIdentifier – уникальный идентификатор сниппета

IDECodeSnippetLanguage – язык кода в сниппете. У нас используется Swift – Xcode.SourceCodeLanguage.Swift

IDECodeSnippetTitle – наименование сниппета

IDECodeSnippetUserSnippet – булевое значение для принадлежности пользовательскому сниппету

IDECodeSnippetVersion – версия сниппета

Создание сниппета

Создать сниппет можно несколькими способами. Расскажу о двух из них:

1) Удобен для создания сниппета из уже написанного кода.

Просто выделяем код в Xcode и перетягиваем его в окно Code Snippet Library.

Xcode предложит заполнить поля для конфигурации сниппета.

2) Удобен для создания сниппета на базе уже созданного.

Заходим в в папку пользовательских сниппетов:

~/Library/Developer/Xcode/UserData/CodeSnippets

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

Для того, чтобы созданные этим путем сниппеты отображались в Xcode – необходимо его перезапустить.

Примеры

Несколько примеров для быстрого написания swift-кода в определенных случаях. Все они доступны на GitHub.

MARK – маркировка секций swift-кода

NSLocalizedString – локализированная строка

AddObserver – добавление наблюдателя за событием

UITableViewDataSource+Delegate – реализация протокола UITableViewDataSource и UITableViewDelegate

PrepareForSegue – реализация метода навигации

 

Прокачиваем Xcode: Шаблоны

Posted on by Posted in FAQ, iOS, Код, Проекты Leave a comment

xcode

Сегодня я расскажу как можно добавить свои шаблоны файлов в Xcode.

Вообще такая возможность в Xcode была всегда, сколько его помню, но тем не менее ранее я об этом не писал.

xctemplate

Введение

Xcode-шаблоны – это готовые макеты проектов или файлов для быстрого создания.

Давайте рассмотрим структуру Xcode-шаблона.

Шаблон – это папка  с расширением xctemplate. Состоит как минимум из следующих файлов:

TemplateInfo.plist – файл конфигурации шаблона

TemplateIcon.png – иконка шаблона (рекомендуется использовать еще и TemplateIcon@2x.png для Маков с ретиной)

___FILEBASENAME___.swift – шаблон файла исходных кодов. В данном случае мы используем Swift

 

xctemplate

Давайте подробнее рассмотрим файл конфигурации TemplateInfo.plist, а точнее ключи, которые в нем используются:

AllowedTypes – массив используемых типов файлов в шаблоне. А нашем случае используется Swift: public.swift-source

DefaultCompletionName – имя файла по умолчанию. Используется при создании файла из шаблона

Description – краткое описание шаблона

Kind – тип шаблона. В нашем случае используется шаблон файла: Xcode.IDEFoundation.TextSubstitutionFileTemplateKind

MainTemplateFile – имя файла, который будет использоваться в качестве шаблона. В нашем случае используется ___FILEBASENAME___.swift

Summary – подробное описание шаблона

SortOrder – порядок для сортировки шаблонов. Чем больше значение, тем дальше он будет отображаться в списке шаблонов.

 

Расположение

Предустановленные Xcode-шаблоны проектов и файлов хранятся в папке  самого Xcode:

Общие – /Applications/Xcode.app/Contents/Developer/Library/Xcode/Templates

Для платформы iOS – /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates

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

Чтобы наши шаблоны не были зависимыми от Xcode, необходимо создать следующий путь и помещать туда шаблоны:

~/Library/Developer/Xcode/Templates/File Templates/User Templates/

Xcode templates

Примеры

Я подготовил пару примеров шаблонов для быстрого создания классов в парадигме MVC (включая распределение ViewController). Все они доступны на GitHub.

Model – класс модели с базовой инициализацией

View – класс вьюшки

ViewController – класс контроллера с базовыми часто используемыми методами

ViewController+Logic – расширение для контроллера, где будет реализовываться логика. Например, начальное конфигурирование и обновление UI

ViewController+UITableViewDataSource+Delegate – расширение для контроллера, где будет логика реализации протоколов UITableViewDataSource и UITableViewDelegate

Cell – класс ячейки таблицы

Helper – класс хелпера

 

Это далеко не все шаблоны, которые хотелось бы реализовать. Возможно, база будет пополняться.

Что примечательно, после добавления нового шаблона, не нужно перезапускать Xcode. При создании нового файла будет виден новый шаблон.

DarknessBot – взгляни на свое моноколесо по-новому!

Posted on by Posted in iOS, Анонс, Без рубрики, Истории, Приложения Leave a comment

DarknessBot

Технологии движутся вперед, и на улицах городов новыми современными гаджетами никого не удивить. Вот и недавно такой мобильный транспорт, как моноколесо, стал набирать популярность. Новые модели становятся все технологичнее, без наличия Bluetooth LE вообще сложно себе их представить. Такие моноколеса всегда снабжены стандартным китайским мобильным приложением на iOS/Android. Со своим странным дизайном, ограниченным функционалом,  и багами, присущим конкретным брендам.

Хватит это терпеть! Долгое время я использовал стандартное приложение Ninebot, которое показывает только текущее состояние моноколеса. Потом понял, что в нем мне не хватает данных за прошедшее время для ответа на один простой вопрос: Сколько я сегодня проехал? Поэтому я и решил написать свое собственное приложение, которое было бы мне удобно.

DarknessBot

С ростом возможностей всегда приходит рост потребностей. Добавил возможность вибрировать на конкретной скорости, кастомизировать интерфейс, поддержку Apple Watch, а также вычислять оставшийся пробег на основе данных о весе (через HealthKit), погоде, данных батареи и текущей погоде, и многое другое.

DarknessBot

Киллер-фичами приложения стали возможность смотреть графики данных за долгий период, а также записывать видео с нанесенными на них метриками в лайф-режиме.

 

DarknessBot Recorder

DarknessBot Graph

Недавно приобрел новое колесо Inmotion V8, пришлось адаптировать приложение и под него. А заодно и для KingSong и Gotway по заявкам телезрителей райдеров.

При всем этом компании, производящие моноколеса, на текущее время не предоставляют SDK для взаимодействия с устройством. Пришлось кооперироваться с испанским разработчиком 9BMetrics и изобретать API вручную.

Приложение доступно бесплатно в Appstore.