Agapov Alexey

Resources

Tue, 10 Jan 2023 17:18:00 +0500

🐦 Крутые авторы и разработчики в твиттере

📫 Периодические материалы

podlodka.io — подкаст обо всём
iosdevweekly.com — недельный дайджест мира iOS/macOS разработки

✍️ Блоги

objc.io — статьи и видео
swiftbysundell.com — блог и подкаст, хорошие статьи по базовым материалам
nshipster.com — блог с глубокими знаниями и разбором от инженера Apple
avanderlee.com — блог с хорошим контентом на разные темы.
pointfree.co — видео, есть бесплатные. Функциональные подходы.
useyourloaf.com — отличный блог и книга про AutoLayout. Контент книги = статьи из блога.
refactoring.guru/ru - отличный сайт, есть книга. Паттерны ООП, разбор рефакторинга, примеры кода.
hackingwithswift.com — хороший контент. Первый выбор для поиска типичных решений вместо stackoverflow

📰 Статьи

Поверхностный обзор архитектур
Математические основы AutoLayout
MVC, и как его можно улучшить. Отличная статья про FlowController, Child controllers.
FlowController против Coordinator
Test doubles in Swift: dummies, fakes, stubs, and spies.

📖 Книги

App Architecture – книга по архитектурам с примерами
Книги на objc.io
Разные книги с крутым контентом Для начала в iOS хорошая iOS Apprentice.
Книги от Mattt (NSHipster) для углубленного изучения

🧡 Swift

Перевод официальной книги Swift от Apple
Сравнение фич swift по-версиям
Стандартная библиотека Swift

🍏 WWDC must watch

🎥 Видео

MVC is not your problem — доклад о том, как делать MVC, не делая его massive.
Правильный MVC — как справиться с MVC. Доклад от Redmadrobot
Как работать с сетью правильно — доклад от Сбербанка. URLSession и правильные подходы к работе с сетью.

📚 Хранилища знаний

TeamLead roadmap – как развиваться самому в качестве тимлида

Swift Package Manager in 2021

Sun, 25 Jul 2021 10:40:20 +0500

Вопросы

Почему стоит уйти с Cocoapods?
Как интегрировать пакеты? Что со сборкой на CI?
Как структурировать пакеты в SwiftPM
Как удобно разрабатывать отдельный пакет
Как удобно выделять модуль для приложением
Как выпускать версии пакетов и библиотек

Почему стоит уйти с Cocoapods

SwiftPM поддерживает всё, что поддерживает Cocoapods и даже чуть больше.

Поддержка ресурсов

Работает, начиная с Xcode 12 и Swift 5.3.

Ресурсы не обязательно объявлять в Package.swift файле. Например, asset catalogs, xib/storyboard, .lproj файлы будут включены в Bundle автоматически.

When you add a resource to your Swift package, Xcode detects common resource types for Apple platforms and treats them as a resource automatically. For example, you don’t need to make changes to your package manifest for the following resources:

Interface Builder files; for example, XIB files and storyboards

Core Data files; for example, xcdatamodeld files

Asset catalogs

.lproj folders you use to provide localized resources

Bundling resources

Использовать ресурсы в коде стало проще. Внутри Swift Package Manager пакета мы можем написать просто Bundle.module.

UIImage(named: "some_image", bundle: .module)

Это работает благодаря флагу SWIFT_PACKAGE, который доступен внутри пакета.

Пример добавления ресурсов описан в статье useyourloaf.

Подробнее в видео WWDC20. Swift packages: Resources and localization

SwiftGen, R.swift

Работает через Bundle.module.

Нет явных шагов для билда ресурсов, как и с обычными пакетами. Кажется, имеет смысл держать рядом папку scripts с cli. И запускать периодически в терминале.

Умеет в версионирование

Выбор версии до следующей мажорной (95% использования)
Конкретная версия
Конкретная ветка

Поддерживает binary frameworks

Поддержка xcframework нужна для библиотек, у которых мы хотим закрыть исходный код. Или, например, у KMM библиотеки, которая нужна как зависимость.

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

Подробнее об этих фреймоврках и интеграции в Swift Package Manager в видео Distribute binary frameworks as Swift Packages и документации о Binary Frameworks

Интеграция пакетов и сборка на CI

Внешние пакеты внутри приложения

Пакеты можно добавлять через File > Swift Packages. Поиск по url пакета. Пакет скачается и попробует построить дерево совместимости.

swift package умеет создавать, собирать и запускать модули. Поставляется вместе с Xcode.

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

Модульное приложение на Swift Package Manager

Модули выделять стало намного проще. File > New > Swift Package. Добавляя его в репозиторий и проект - появляется понятная структура. Она повторяет файлы внутри, в отличие от обычных проектов. Генерируется папка тестов, автоматом считывается Scheme для билда и тестирования пакета. Зависимости такого модуля можно объявить в Package.swift

Структура пакетов

1 репозиторий = коллекция пакетов.

Executable — cli. Удобно разрабатывать с любыми пакетами, которые тоже поддерживают SwiftPM. swift-argument-parser — мощь.

К сожалению, использовать с SPM SwiftGen/R.swift и любые другие CLI, как это было с Cocoapods - не получится. Валидные решения такие:

положить бинарь с утилитой в код проекта и запускать внутри. Будет не очень удобно обновляться, но все остальные удобства останутся.
использовать Brewfile/Gemfile для контроля зависимостей. Будет удобно обновлять, но нужно запускать перед билдом brew install/bundle install

Library — библиотека. Может быть как статической, так и динамической.

Как удобно разрабатывать

Файловая структура пакета

Внутри репозитория пакета можно собрать такую иерархию файлов:

📁 Project (git repo)
- 📄 Package.swift
- 📄 Package.resolved
- 📄 README.md
- 📁 Sources
  - 📁 Helpers
  - 📁 BigModule
- 📁 Tests
  - 📁 BigModuleTests (folder)
- 📁 Example
  - Example.xcodeproj
  - … any structure of example project
- 📄 Packages.xcworkspace
- Packages.playground (еще не пробовал, но должно тоже работать)

xcworkspace файл объединит в себе две группы

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<?xml version="1.0" encoding="UTF-8"?>
<Workspace
 version = "1.0">
 <FileRef
 location = "group:.">
 </FileRef>
 <FileRef
 location = "group:Example/Example.xcodeproj">
 </FileRef>
</Workspace>

В таком случае xcworkspace повторяет всю структуру папок, при этом имея все схемы для сборки пакетов + схему для сборки Example проекта.

К сожалению, иногда приходится закрыть-открыть workspace. Обычно это проблемы со схемами или резолвом пакетов.

Kontur: мы используем такую иерархию в packages-ios.

Package.swift

// swift-tools-version:5.3 - актуальная версия тулзов. Актуальная фича в этой версии - process/copy ресурсов.

API Reference swift.org — место, где можно посмотреть документацию к каждому вызову внутри Package.swift

Про отличие static и dynamic библиотек можно почитать в блоге theswiftdev.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43


// swift-tools-version:5.3
import PackageDescription

let package = Package(
 name: "SimplePackage",
 platforms: [
 .iOS(.v11) // поддерживает только iOS с версии 11
 ],
 products: [
 .library(
 name: "Helpers",
 targets: ["Helpers"]
 ),
 .library(
 name: "BigModule",
 targets: ["BigModule"]
 )
 ],
 dependencies: [
 .package(url: "https://github.com/marmelroy/PhoneNumberKit", .upToNextMajor(from: "3.3.3")),
 .package(url: "https://github.com/ReactiveX/RxSwift.git", from: "5.0.0"),
 .package(name: "Firebase", url: "https://github.com/firebase/firebase-ios-sdk.git", from: "8.0.0")
 ],
 targets: [
 .target(
 name: "Helpers",
 dependencies: ["PhoneNumberKit"]
 ),
 .target(
 name: "BigModule",
 dependencies: [
 .product(name: "FirebaseRemoteConfig", package: "Firebase"),
 "RxSwift",
 .product(name: "RxCocoa", package: "RxSwift")
 ],
 resources: [.process("Resources")] // Resources — папка в Sources/BigModule
 ),
 .testTarget(
 name: "BigModuleTests",
 dependencies: ["BigModule"]
 ),
 ]
)

Релизы

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

Если хочется выложить пакет в общий доступ и позволить пользователям искать его в общем списке — посмотри на Swift Package Index.

Как решать проблемы

Пакеты начинают резолвиться при открытии Xcode проекта. Если удалить пакеты, то они пропадут и билд не будет их видеть. Тогда нужно воспользоваться меню File > Swift Packages > Resolve Package Versions

Проблемы кэширования решаются удалением кэша 😀 Ссылка на него лежит в ~/.swiftpm/cache. Оригинал лежит в ~/Library/Caches/org.swift.swiftpm. Рядом с кэшем Cocoapods.

Проблема совместимости с тем, что модули не подходят друг другу решается вручную. Как, например, если мы поставим RxSwift 6.0.0+ и последнюю версию Moya, которая работает с RxSwift 5.0.0+. Тогда нужно явно указать, что версия RxSwift необходима старая. Автоматически это не решится, но лог пишется понятный.

Проблема с разными версиями одного пакета

1
2


Dependencies could not be resolved because root depends on 'Moya' 14.0.1..<15.0.0 and root depends on 'Quick' 4.0.0..<5.0.0.
'Moya' >= 14.0.1 practically depends on 'Quick' 2.0.0..<3.0.0 because 'Moya' 14.0.1 depends on 'Quick' 2.0.0..<3.0.0 and no versions of 'Moya' match the requirement 14.0.2..<15.0.0.

Не вижу возможного решения в текущей версии, так как Package.swift нельзя выделить отдельно. Думал о том, чтобы Quick с версией другой имел название библиотеки вроде Quick-4, и тогда бы не должна была ломаться связка. Но как такое решить с текущей интеграцией Xcode - не понятно.

Валидные решения на сейчас:

выпилить Quick из тестов :)
обновить Moya в отдельном репозитории. Версия 15 с поддержкой RxSwift давно готова. Но её не выпускают непонятно почему. Скорее всего, проблема в документации.

Полезные ссылки

Обзор по SwiftPM от Apple

Документация по API SwiftPM в Package.swift файле

Видео WWDC про Swift Packages

Публичный список доступных пакетов в SwiftPM

UPD: 12.2021

Всё ещё очень долго происходит загрузка пакетов при открытии проекта в Xcode. Если подряд открыть проект несколько раз — то и загрузка будет происходить каждый из этих раз. Это может занимать очень много времени. В Cocoapods же можно было не обновлять и не подтягивать каждый раз пакеты.

Modern Collection Views

Wed, 21 Jul 2021 10:49:14 +0500

source от Apple

iOS 14+ для реализации всех фич. В iOS 13 ввели diffable data source. В iOS 14 появился compositional layout, реализующий все возможности таблиц и улучшающий коллекции.

Почему не таблица?

Горизонтальный скролл
Удобно конфигурировать state. highlighted/selected/disabled

Что позволяет делать?

Collapsible/Expandable Sections
Секции с разным layout. inset grouped, sidebar (iPad-related), horizontal scroll, columns.

Главные фичи

Data source

Data-driven работает через… RxDataSources? DifferenceKit? Native! Собираем NSDiffableDataSourceSnapshot, применяем.

1
2
3
4


var snapshot = NSDiffableDataSourceSnapshot<Section, Int>()
snapshot.appendSections([.main])
snapshot.appendItems(Array(0..<94))
dataSource.apply(snapshot, animatingDifferences: false)

Data source — конфигурация с cellRegistration

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


let cellRegistration = UICollectionView.CellRegistration<TextCell, Int> { (cell, indexPath, identifier) in
 // Populate the cell with our item description.
 cell.label.text = "\(identifier)"
}
dataSource = UICollectionViewDiffableDataSource<Section, Int>(
 collectionView: collectionView
) { (
 collectionView: UICollectionView,
 indexPath: IndexPath,
 identifier: Int
) -> UICollectionViewCell? in
 // Return the cell.
 return collectionView.dequeueConfiguredReusableCell(using: cellRegistration, for: indexPath, item: identifier)
}

Есть одна проблемка с native data source. Он постоянно будет удалять и затем добавлять новую ячейку, не делая reload данных на месте (тут говорят). DifferenceKit позволяет это делать, поддерживает перезагрузку. Бенчмарки этой либы говорят, что она самая быстрая среди всех похожих либ. Хорошая либа Но для использования с новым API cellRegistration нужно использовать native Data source

Layout для сложных экранов

DistinctSectionsViewController как пример разных layout для разных секций.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


let layout = UICollectionViewCompositionalLayout { (
 sectionIndex: Int,
 layoutEnvironment: NSCollectionLayoutEnvironment
 ) -> NSCollectionLayoutSection? in

 guard let sectionLayoutKind = SectionLayoutKind(rawValue: sectionIndex) else { return nil }
 let columns = sectionLayoutKind.columnCount

 // The group auto-calculates the actual item width to make
 // the requested number of columns fit, so this widthDimension is ignored.
 let itemSize = NSCollectionLayoutSize(
 widthDimension: .fractionalWidth(1.0),
 heightDimension: .fractionalHeight(1.0)
 )
 let item = NSCollectionLayoutItem(layoutSize: itemSize)
 item.contentInsets = NSDirectionalEdgeInsets(top: 2, leading: 2, bottom: 2, trailing: 2)

 let groupHeight = columns == 1 ?
 NSCollectionLayoutDimension.absolute(44) :
 NSCollectionLayoutDimension.fractionalWidth(0.2)
 // Element height takes 20% of section width
 let groupSize = NSCollectionLayoutSize(
 widthDimension: .fractionalWidth(1.0),
 heightDimension: groupHeight
 )
 let group = NSCollectionLayoutGroup.horizontal(layoutSize: groupSize, subitem: item, count: columns)

 let section = NSCollectionLayoutSection(group: group)
 section.contentInsets = NSDirectionalEdgeInsets(top: 20, leading: 20, bottom: 20, trailing: 20)
 section.contentInsetsReference = .readableContent
 return section
}

Layout Environment с размерами и трейтами позволит менять layout. Например, в несколько колонок на айпад. Пример — AdaptiveSectionsViewController
Отношение к отступам от родных layout margins/readable guide. Настройка у NSCollectionLayoutSection
Поведение скролла можно контролировать у секции. Например, с остановкой у leading границы элемента. OrthogonalScrollBehaviorViewController

Cell Configuration

У UICollectionViewCell можно по новой управлять свойствами. contentConfiguration настраивает контент (текст, accessory

List Cell для Expandable/Collapsible sections. Позволяет изменять indentation (отступ слева) UICollectionViewListCell

Хорошие новости для дизайнеров

Тень для всей секции insetGrouped элементов. Или рамка.

Изи! SectionBackgroundDecorationView в примере.

Прилипающие хедеры/футеры секций

Изи! PinnedSectionHeaderFooterViewController в примере.

Пагинация при скролле

OrthogonalScrollBehaviorViewController в примере