Когда вы только начинаете разрабатывать приложения для iPhone или iPad, первым делом сталкиваетесь с необходимостью изучить официальные материалы от Apple. Но как именно называется то самое «руководство для разработчиков iOS», которое все рекомендуют? Ответ не так однозначен, как кажется: у Apple есть целый набор документов с разными названиями, целями и уровнями детализации. Одни описывают дизайн-концепции, другие — технические API, третьи содержат примеры кода.
В этой статье мы разберём все виды официальной документации для iOS-разработчиков: от базовых гайдов до глубоких технических справочников. Вы узнаете, где их найти, как они называются на английском и русском, а также какие из них актуальны для Swift, SwiftUI и Objective-C. Особое внимание уделим разнице между Human Interface Guidelines и API Reference — двумя ключевыми типами документов, которые часто путают новичков.
1. Human Interface Guidelines (HIG) — «Библия» дизайна интерфейсов iOS
Human Interface Guidelines (сокращённо HIG) — это основной документ, который определяет, как должны выглядеть и работать приложения на платформе iOS. Его часто называют «дизайн-гайдом» или «руководством по пользовательскому интерфейсу». Apple обновляет HIG ежегодно, добавляя разделы про новые функции (например, Dynamic Island или WidgetKit).
В HIG вы найдёте:
- 🎨 Принципы дизайна: как создать интуитивно понятный интерфейс (например, правило «не перегружать экран» или «использовать жесты естественно»).
- 📱 Шаблоны экранов: рекомендации по компоновке элементов для iPhone и iPad (включая
Split ViewиSlide Over). - 🖼️ Системные иконки и символы: как использовать SF Symbols (набор из 4 000+ векторных иконок от Apple).
- 🌐 Локализация и доступность: как адаптировать интерфейс для разных языков и пользователей с ограниченными возможностями.
⚠️ Внимание: HIG — это не техническая документация, а скорее философия дизайна. Здесь нет кода, зато есть сотни примеров «как делать правильно» и «как не надо». Например, Apple категорически не рекомендует использовать UITabBar с более чем 5 вкладками или размещать кнопки слишком близко к краям экрана (из-за жеста свайпа назад).
2. API Reference — технический справочник для программистов
Если HIG рассказывает «как должно выглядеть», то API Reference (или Developer Documentation) объясняет «как это запрограммировать». Это техническая документация, где подробно описаны все классы, методы, протоколы и фреймворки, доступные в iOS SDK.
Где искать API Reference:
- 📖 Официальный сайт: developer.apple.com/documentation (самый полный и актуальный источник).
- 🔍 Xcode: нажмите
Help → Developer Documentationили используйте быстрый поиск по символуShift + Command + 0. - 📱 Приложение Apple Developer: есть мобильная версия документации для iPhone/iPad.
Примеры разделов API Reference:
| Фреймворк | Что описывает | Пример класса |
|---|---|---|
UIKit |
Интерфейсные элементы (кнопки, таблицы, анимации) | UITableView, UIButton |
SwiftUI |
Декларативный фреймворк для создания UI | View, @State |
Core Data |
Работа с базами данных | NSManagedObject |
AVFoundation |
Воспроизведение и запись медиа | AVAudioPlayer |
⚠️ Внимание: API Reference обновляется с каждой новой версией iOS. Например, в iOS 17 появились новые классы для WidgetKit и TipKit, которых не было в iOS 16. Всегда проверяйте версию SDK в верхнем правом углу документации!
3. WWDC Sessions — видеоуроки и презентации от инженеров Apple
Ежегодно на конференции WWDC (Worldwide Developers Conference) Apple публикует сотни видеосессий, где её инженеры рассказывают о новых возможностях iOS, Swift и других технологий. Эти видео — не просто руководства, а глубокие технические разборы с примерами кода, лучшими практиками и инсайдами «изнутри».
Как пользоваться WWDC-сессиями:
- 🎥 Смотрите на официальном сайте: developer.apple.com/videos (доступно бесплатно после регистрации как разработчика).
- 📝 Ищите по тегам: фильтруйте по годам (WWDC23, WWDC22) или темам (SwiftUI, Privacy).
- 🔗 Скачивайте сопроводительные материалы: к каждому видео прилагаются слайды, примеры кода и ссылки на документацию.
Примеры полезных сессий:
- 🆕 «What’s new in SwiftUI» — обзор нововведений в SwiftUI за последний год.
- 🔒 «Protect user privacy in your apps» — как работать с разрешениями и данными пользователей.
- 🎮 «Bring your game to life with SwiftUI» — интеграция игр с SwiftUI.
⚠️ Внимание: WWDC-сессии часто содержат эксклюзивную информацию, которой нет в письменной документации. Например, в 2023 году на WWDC рассказали о новых возможностях MapKit для 3D-карт, которые не были сразу описаны в API Reference.
Где найти субтитры к WWDC-видео?
Нажмите на кнопку CC в плеере на сайте Apple Developer. Субтитры доступны на английском и нескольких других языках, включая русский (для некоторых сессий).
4. Sample Code — готовые примеры проектов от Apple
Один из самых эффективных способов научиться разрабатывать под iOS — изучать готовые примеры кода от Apple. Эти проекты покрывают типичные задачи: от работы с Core Location до интеграции Sign in with Apple.
Где скачать Sample Code:
- 💻 Официальный репозиторий: developer.apple.com/documentation/sample-code.
- 📦 Через Xcode:
File → New → Project → iOS → Sample Code. - 🐙 GitHub: некоторые проекты дублируются в репозитории apple.
Примеры полезных проектов:
| Название проекта | Что демонстрирует | Язык |
|---|---|---|
Scrumdinger |
Работа с SwiftUI и Combine | Swift |
Creating a Custom Camera |
Интеграция камеры с AVFoundation | Swift/Obj-C |
WeatherKit |
Получение данных о погоде через API | Swift |
⚠️ Внимание: Примеры кода от Apple часто используют новейшие API, которые могут не работать на старых версиях iOS. Всегда проверяйте требования к версии SDK в файле Info.plist проекта.
☑️ Как правильно использовать Sample Code
5. Technical Notes и Release Notes — краткие обновления и исправления
Помимо основной документации, Apple публикует два типа кратких заметок:
- Technical Notes (TN) — глубокие разборы конкретных технических вопросов (например, как оптимизировать работу с Core Bluetooth или избежать утечек памяти в ARKit).
- Release Notes — список изменений в каждой новой версии iOS, Xcode или SDK. Здесь перечислены новые API, исправленные баги и известные проблемы.
Где их читать:
- 📝 Technical Notes: раздел Archive на сайте разработчика (многие TN устарели, но некоторые актуальны).
- 📋 Release Notes: страница с заметками о релизах.
Пример полезной информации из Release Notes:
- ⚠️ В iOS 17.2 изменилось поведение
UIRefreshControl— теперь оно автоматически скрывается при скролле. - ✅ В Xcode 15 добавили поддержку Swift 5.9 и новые шаблоны для WidgetKit.
6. Books и Tutorials — учебные материалы для новичков
Если вам нужна структурированная обучающая программа, Apple предлагает несколько бесплатных книг и туториалов:
- 📚 «Swift Playgrounds» — интерактивное обучение Swift через игры (доступно как приложение для iPad/macOS).
- 📖 «Develop in Swift» — серия книг от Apple Education (подходит для школ и университетов).
- 🎓 «Apple Developer Tutorials» — пошаговые гайды по созданию первых приложений.
Где их найти:
- 🌍 Books: Apple Books (бесплатно).
- 💻 Tutorials: раздел Tutorials на сайте разработчика.
⚠️ Внимание: Учебные материалы от Apple часто обновляются медленнее, чем основная документация. Например, книга «Develop in Swift» может использовать Swift 5.5, тогда как актуальная версия — Swift 5.9. Всегда сверяйтесь с последними версиями фреймворков.
7. Forums и Bug Reporter — где задавать вопросы и сообщать об ошибках
Даже с самой полной документацией у разработчиков возникают вопросы. Для этого Apple предоставляет:
- 💬 Apple Developer Forums (forums) — официальное сообщество, где можно обсудить технические проблемы с другими разработчиками и инженерами Apple.
- 🐛 Feedback Assistant (Bug Reporter) — инструмент для отправки баг-репортов и предложений по улучшению SDK.
Советы по использованию форумов:
- 🔍 Ищите перед тем, как спрашивать — многие вопросы уже обсуждались.
- 📌 Указывайте версию iOS/Xcode — это поможет быстрее получить ответ.
- 📎 Прикрепляйте код или скриншоты — так проще диагностировать проблему.
⚠️ Внимание: На форумах Apple действуют строгие правила: нельзя обсуждать бета-версии iOS вне специального раздела, а также публиковать конфиденциальную информацию (например, данные из App Store Connect). За нарушение могут заблокировать аккаунт разработчика.
FAQ: Частые вопросы о документации для iOS-разработчиков
🔹 Как называется основное руководство по дизайну интерфейсов для iOS?
Human Interface Guidelines (HIG) — это официальное название документа, который описывает принципы дизайна для iOS, iPadOS и других платформ Apple. На русском его часто называют «руководством по интерфейсу» или «гайдом по UX/UI».
🔹 Где скачать API Reference для SwiftUI?
API Reference для SwiftUI доступен на сайте developer.apple.com/documentation/swiftui. Также его можно открыть прямо в Xcode, нажав Shift + Command + 0 и введя название класса (например, View).
🔹 Чем WWDC-сессии отличаются от Sample Code?
WWDC-сессии — это видеолекции с объяснениями и примерами использования новых технологий, а Sample Code — готовые проекты с исходным кодом, которые можно скачать и модифицировать. Сессии полезны для понимания концепций, а Sample Code — для практики.
🔹 Как понять, какая версия документации актуальна для моего проекта?
В верхнем правом углу любой страницы документации на сайте Apple есть выпадающий список с версиями iOS/Swift. Выберите ту версию, которую используете в проекте (указана в Deployment Target в Xcode). Например, если ваше приложение поддерживает iOS 16+, выбирайте документацию для iOS 16.
🔹 Можно ли использовать документацию Apple на русском языке?
Большая часть документации переведена на русский, но не полностью. Например, HIG и основные разделы API Reference доступны на русском, а WWDC-сессии и Technical Notes — только на английском. Чтобы переключить язык, нажмите на значок 🌐 в верхнем меню сайта Apple Developer.