CocoaPods
August 17, 2023

Устанавливаем CocoaPods и Realm

Это руководство по установке CocoaPods и Realm я написал в большей степени для себя, как заметку! Но, если эта статья кому-то пригодится, то я буду только рад. (-:

Итак, начнем!
Сначала краткое пояснение о том …

… что такое CocoaPods?

CocoaPods — это мощное и одновременно изящное средство управления зависимостями Cocoa-библиотек, которые разработчики используют в своих iOS и macOS проектах.

… что такое Realm?

Realm — это кроссплатформенная мобильная база данных для iOS (Swift, Objective-C) и Android. Realm построен чтобы быть лучше и быстрее, чем SQLite и Core Data. Она не просто лучше и быстрее, она легка в использовании, и Вы сможете делать много вещей используя всего несколько строк кода.


Установка CocoaPods

Для установки CocoaPods открой Терминал и введи следующую строку:

$ sudo gem install cocoapods //актуальная версия cocoapods
$ sudo gem install cocoapods --pre //тестовая версия

Если у тебя уже установлен CocoaPods, то возможно его надо обновить. В Терминале введи эти строки

$ gem list --local | grep cocoapods //узнать установленную версию

$ pod repo update //обновить cocoapods

Вот и всё! CocoaPods установлен/обновлен. CocoaPods Guides.

Чтобы удалить CocoaPods (удаляет все версии):

$ gem list --local | grep cocoapods //узнать установленную версию

Удаляем CocoaPods

$ sudo gem uninstall cocoapods
$ sudo gem uninstall cocoapods-core
$ sudo gem uninstall cocoapods-downloader

Удалить старый основной репозиторий:

$ sudo rm -fr ~/.cocoapods/repos/master


Список часто используемых команд терминала:

$ help // список команд

$ help имя_команды // cправка по конкретной команде

$ cd // перейти в папку выше

$ cd .. // перескочить в “родную” папку, обычно это /users/имя_пользователя

$ cd / // перейти в корневую папку диска

$ cd ~ // прямой переход в основную папку 
// пользователя /users/имя_пользователя

$ cd ~/Documents // перейти в папку документы принадлежащую текущему 
// пользователю. Таким образом, можно переходить и в другие 
// папки пользователя 

$ cd Documents/region/ // переход в папку Documents/region/

$ cd /pictures // попытка перехода в директорию pictures расположенную 
// в КОРНЕВОЙ папке диска

$ cd pictures // попытка перехода в папку pictures в текущей папке

$ cd ‘Имя папки’ и cd Имя\ папки // имя папки с “пробелом” должно быть 
// заключено в одинарные кавычки или должен быть обратный 
// слэш перед пробелом

$ pwd // она показывает, где вы сейчас находитесь (print working directory)


Установка Realm с помощью CocoaPods

Для начала, тебе необходимо создать в Xcode новый проект “Single View Application” и назвать его, например “region” или как нравиться.

Теперь закроем Xcode.

Потом переходим к папке нашего созданного проекта region, для этого вводим в Терминале (у меня проект лежит в папке Documents/XcodeProjects/region/):

$ cd Documents/XcodeProjects/region/

убедиться что ты сделал всё верно, можно командой

$ pwd //покажет текущую папку

Применение:

$ pod COMMAND

CocoaPods, менеджер пакетов библиотеки Cocoa.

Команды:

+ cache         Управление кешем CocoaPods
+ deintegrate   Деинтегрировать CocoaPods из вашего проекта
+ env           Display pod environment
+ init          Создайте Podfile для текущего каталога
+ install       Установите зависимости проекта в соответствии с версиями из Podfile.lock
+ ipc           Inter-process communication
+ lib           Develop pods
+ list          List pods
+ outdated      Показать устаревшие зависимости проекта
+ plugins       Показать доступные плагины CocoaPods
+ repo          Manage spec-repositories
+ search        Поиск pods
+ setup         Настройте среду CocoaPods
+ spec          Управление pod specs
+ trunk         Взаимодействие с CocoaPods API (например, публикация новых specs)
+ try           Try a Pod!
+ update        Обновите устаревшие зависимости проекта и создайте новый Podfile.lock

Параметры:

--allow-root    Позволяет CocoaPods работать от имени root
--silent        ничего не показывать
--version       Показать версию tool
--verbose       Показать больше информации об отладке
--no-ansi       Показать вывод без кодов ANSI
--help          Показать справку указанной команды

далее, инициализируем Cocoapods

$ pod init

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

$ sudo gem update xcodeproj

а потом повторить

$ pod init

Далее, когда Podfile создался, прописываем в нем необходимые фреймворки для установки в проект, в нашем случае мы устанавливаем Realm, поэтому добавляем строку pod 'RealmSwift', '~>10'

platform :ios, '12.0'

target 'region' do
# Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

# Pods for region
  pod 'RealmSwift', '~>10'

end

Потом вводим команду в Терминале, и ждем установки Realm

$ pod install

По завершении в папке проекта появятся новые файлы:

  • Pods (папка)
  • Podfile.lock
  • region.xcworkspace

С этого момента для работы с проектом Вам нужно будет открывать файл region.xcworkspace


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

GitHub Realm Swift -> https://github.com/realm/realm-swift

Документация -> https://www.mongodb.com/docs/realm/sdk/swift/

GitHub Realm Studio -> https://github.com/realm/realm-studio

Скачать Realm Studio MacOS -> https://studio-releases.realm.io/latest/download/mac-dmg