Rambler.iOS #4: Создание модульных приложений на примере Рамблер.Кассы

Создание модульных приложений на примере

“Рамблер.Кассы”

О чем?

• Введение в историю “Рамблер.Касса”

• Что используем

• Пример

О чем?



• Пример

О чем?



• Пример

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

Глоссарий

Модульность — это свойство системы, связанное с возможностью ее декомпозиции на ряд внутренне связанных между собой модулей

Глоссарий

Немного истории

• Приложение, отображающее информацию по событию: - кино - спектакли - спорт

• Возможность купить билеты на эти события без наценки

• iPhone и iPad версии

Что же такое “Рамблер.Касса”?





















• Проект развивается

• Появляется первая “брендированная версия”


Что же такое “брендированная” версия?

• Отдельное приложение, существующее обособленно от основной версии

• Имеет свои особенности: - своя цветовая схема, логотипы и т.д. - отличный от основной кассы функционал






• Общий функционал

• Отличный функционал

• Количество версий только растет

Проблема

Проблема

Проблема

Расписание

Поддержка Билеты

Карта

Спорт

Кино Кино

Кино

Проблема


Билеты

Карта


Поддержка

Билеты

Как это было?

• Один проект для всех версий

• Множество таргетов

• Ветвления через “if” по define макросам

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { #ifdef BOLSHOI switch (section) { case 2: return 2; case 3: return 2; default: return 0; } #else switch (section) { case 0: return 2; case 1: return 1;

default: return 0; } #endif }


- (instancetype)init { self = [super init]; NSString *bundleIdentifier = [[NSBundle mainBundle] infoDictionary][@"CFBundleIdentifier"]; if ([bundleIdentifier rangeOfString:@"cinemapark"].location != NSNotFound) { // CINEMA PARK _tintColor = [UIColor colorWithRed:31.f / 255.f green:110.f / 255.f blue:180.f / 255.f alpha:1.f]; _navigationBarTintColor = [UIColor colorWithRed:4.f/255.f green:110.f/255.f blue:180.f/255.f alpha:1.f]; _navigationBarTitleColor = [UIColor whiteColor]; _shouldShowTheaters = NO; _onlyOneCinema = NO; #if !defined(AF_APP_EXTENSIONS) [[UIApplication sharedApplication] setStatusBarStyle:UIStatusBarStyleLightContent]; #endif if ([bundleIdentifier hasSuffix:@".dev"]) { _widgetKey = @"foo"; } else { _widgetKey = @"foo"; } } else if ([bundleIdentifier rangeOfString:@"Bolshoi"].location != NSNotFound) { // Bolshoi Rostov _tintColor = [UIColor kassaBolshoiMainColor]; _navigationBarTintColor = [UIColor kassaBolshoiMainColor]; _navigationBarTitleColor = [UIColor kassaBolshoiActiveTabsColor]; _selectedBarItemColor = [UIColor kassaBolshoiActiveTabsColor]; _unselectedBarItemColor = [UIColor kassaBolshoiSecondaryColor]; _barTextColor = [UIColor kassaBolshoiActiveTabsColor]; _shouldShowTheaters = NO; _onlyOneCinema = YES; if ([bundleIdentifier hasSuffix:@".dev"]) { _widgetKey = @"foo"; } else { _widgetKey = @"foo"; } }else { // KASSA APP _tintColor = [UIColor colorWithRed:255.f / 255.f green:133.f / 255.f blue:47.f / 255.f alpha:1.f]; _navigationBarTintColor = nil; _navigationBarTitleColor = nil; _selectedBarItemColor = _tintColor; _unselectedBarItemColor = nil; _barTextColor = nil; _shouldShowTheaters = YES; _onlyOneCinema = NO; if ([bundleIdentifier hasSuffix:@".dev"]) { _widgetKey = @"foo"; } else { _widgetKey = @"foo"; } } return self; }

if ([bundleIdentifier rangeOfString:@"cinemapark"].location != NSNotFound) { // CINEMA PARK _tintColor = [UIColor colorWithRed:31.f / 255.f green:110.f / 255.f blue:180.f / 255.f alpha:1.f];



Решение

• Модуль - экран приложения, выполняющий свою функцию

• Саб-модуль - отдельная функциональность конкретного модуля, отвечающая за единственную обязанность

Решение

• Разбить приложение на модули

• Разбить каждые модули на саб-модули

• Подключать нужные модули, а с ними и нужные саб-модули для конкретных таргетов

Решение

Решение

Модуль “кинотеатры”

• Получает через API список кинотеатров

• Отображает этот список

• Осуществляет навигацию на другие модули

Решение


view presenter

router

interactor

entity

entity

entity

Решение


view presenter

router

interactor entityservice

data source provider

data source converter

ui configurator

view presenter

router




ui configurator

Решение


view presenter

router




ui configurator

Решение


view presenter

router




ui configurator

Решение


view presenter

router




ui configurator

Решение


view presenter

router




ui configurator

Решение


view presenter

router




ui configurator

Решение


Nimbus

Решение

Nimbus

Cell Object

Решение

Nimbus

Cell ObjectСконфигурированная

ячейка

Решение

view presenter

router




ui configurator

Решение


view presenter

router




ui configurator

Решение


TYPHOON

Решение

Решение@interface RKCinemasDefaultConfiguratorAssembly : TyphoonAssembly

@property (nonatomic, strong) RKSharedAssembly *sharedAssembly;

- (id<RKCinemasViewProtocol, RKBaseListViewOutConfiguratorProtocol, RKCinemasDataProviderDelegate>)cinemasViewController; - (id<RKCinemasPresenterViewOutputProtocol, RKCinemasPresenterInteractorOutputProtocol>)cinemaPresenter; - (id<RKCinemasInteractorProtocol>)cinemasInteractor; - (id<RKCinemasRouterProtocol>)cinemasRouter; - (id<RKCinemasServiceProtocol>)cinemasService; - (id<RKBaseListViewConfiguratorProtocol>)cinemaConfigurator; - (id<RKCinemasDataSourceProviderProtocol>)cinemasDataSourceProvider; - (id<RKCinemasDataSourceConverterProtocol>)cinemasDataConverter;

@end

Решение

Активация фабрики

Решение

Решение

Решение


view presenter

router




ui configurator

view presenter

router




ui configurator

Решение


view presenter

router




ui configurator

RKCinemasDataConverter

Решение


view presenter

router




ui configurator

RKCinemasDataConverterRKCinemasGiantDataConverter

Решение


Решение@implementation RKCinemasDataConverter

- (NSArray *)convertArrayOfListCinemasToPlaceCellObjects:(NSArray *)list { NSMutableArray *array = [[NSMutableArray alloc] init]; for (RKList *listObject in list) { [array addObject:listObject.title]; NSArray *objects = [self convertListOfCinemasToCellObjects:listObject.objects]; [array addObjectsFromArray:objects]; } return [array copy]; }

- (NSArray *)convertListOfCinemasToCellObjects:(NSArray *)list { NSMutableArray *array = [[NSMutableArray alloc] init]; for (RKPlace *place in list) { [array addObject:[RKListPlaceCellObject objectWithPlace:place]]; } return [array copy]; }

@end

Решение@implementation RKCinemasGiantDataConverter

- (NSArray *)convertListOfCinemasToCellObjects:(NSArray *)list { NSMutableArray *array = [[NSMutableArray alloc] init]; for (RKPlace *place in list) { id<RKCinemaDataProtocol>cinemaInfo = [self.dataProvider cinemaInfoById:place.identifier]; NSString *backgroundImageName = [cinemaInfo backgroundImageName]; NSString *logoImageName = [cinemaInfo logoImageName]; [array addObject:[RKPhotoCinemaCellObject objectWithPlace:place backgroundImageName:backgroundImageName logoImageName:logoImageName]]; } return [array copy]; }

- (NSArray *)convertArrayOfListCinemasToPlaceCellObjects:(NSArray *)list { NSMutableArray *array = [[NSMutableArray alloc] init];

for (RKList *listObject in list) { [array addObject:listObject.title]; NSArray *objects = [self convertListOfCinemasToCellObjects:listObject.objects]; [array addObjectsFromArray:objects]; } return [array copy]; }

@end

Решение

#import "RKCinemasDefaultConfiguratorAssembly.h"

@protocol RKCinemasDataProviderProtocol;

@interface RKCinemasGiantConfiguratorAssembly : RKCinemasDefaultConfiguratorAssembly

- (id<RKCinemasDataSourceConverterProtocol>)cinemasDataConverter; - (id<RKCinemasDataProviderProtocol>)giantCinemasDataProvider;

@end

Решение

- (id<RKCinemasDataSourceConverterProtocol>)cinemasDataConverter { return [TyphoonDefinition withClass:[RKCinemasGiantDataConverter class] configuration:^(TyphoonDefinition *definition) { [definition injectProperty:@selector(dataProvider) with:[self giantCinemasDataProvider]]; }]; }

- (id<RKCinemasDataSourceConverterProtocol>)cinemasDataConverter { return [TyphoonDefinition withClass:[RKCinemasDataConverter class]]; }

Definition для основной версии

Definition для “брединрованной” версии

Решениеrambler-kassa.plist

giant.plist

Решение

Заключение

• Код чище

• Уникальный функционал затрагивает только нужные таргеты

• Общий код для всех таргетов

• Тестирование саб-модулей


• Код чище





• Код чище





• Код чище





• VIPER

• NIMBUS

• TYPHOON

Заключение• COCOAPOD (?)

Ссылки

http://typhoonframework.org/

Статья с общими принципами

https://www.objc.io/issues/13-architecture/viper/

Официальный сайт проекта “Тyphoon”

http://habrahabr.ru/company/rambler-co/blog/264683/

https://www.youtube.com/watch?v=LO59z3fjc9k

TYPHOON

Цикл статей от Егора Толстова

Выступление на rambler.ios #3

VIPER

https://medium.com/brigade-engineering/brigades-experience-using-an-mvc-alternative-36ef1601a41f

Вводная статья

NIMBUShttps://github.com/jverkoey/nimbus Исходники и ссылка на wiki проекта

http://www.slideshare.net/Rambler-iOS/nimbus-models Презентация с rambler.ios #1 от Стаса Цыганова

Technology

Rambler.iOS #4: Создание модульных приложений на примере Рамблер.Кассы