# Репозиторий подов Mindbox для CocoaPods

Со 2 декабря 2026 года CocoaPods trunk не принимает новые версии библиотек, подробнее — в [блоге CocoaPods](https://blog.cocoapods.org/CocoaPods-Specs-Repo/). Новые версии Mindbox iOS SDK (поды `Mindbox`, `MindboxNotifications`, `MindboxLogger`) выходят только в репозитории подов Mindbox — [mindbox-cloud/Specs](https://github.com/mindbox-cloud/Specs). Ранее выпущенные версии по-прежнему устанавливаются из trunk. Репозиторий можно подключить заранее, до перехода на новую версию SDK.

Подключите репозиторий, если устанавливаете SDK через CocoaPods. Это нужно в нативных приложениях и расширениях уведомлений, в React Native (`mindbox-sdk`, включая Expo) и во Flutter (`mindbox`) с выключенным Swift Package Manager. Если SDK подключен через Swift Package Manager, ничего менять не нужно. Для новых нативных приложений и Flutter-проектов используйте Swift Package Manager. Как перевести Flutter-проект с CocoaPods на Swift Package Manager — в статье [Добавление SDK в приложение](https://developers.mindbox.ru/docs/add-sdk-flutter#%D0%BF%D0%B5%D1%80%D0%B5%D1%85%D0%BE%D0%B4-%D1%81-cocoapods-%D0%BD%D0%B0-swift-package-manager).

## Подключение репозитория

В Expo строки `source` в `ios/Podfile` добавляет плагин при `npx expo prebuild`, вручную их добавлять не нужно. Нужная версия плагина — в статье [Базовая установка Expo SDK](https://developers.mindbox.ru/docs/expo-sdk-setup).

1. Добавьте в начало `Podfile` (в React Native и Flutter — `ios/Podfile`):

    ```ruby title="Podfile"
    source 'https://github.com/mindbox-cloud/Specs.git'
    source 'https://cdn.cocoapods.org/'
    ```

    Первая строка подключает репозиторий подов Mindbox, вторая — основной репозиторий CocoaPods для остальных подов. CocoaPods перестает подключать свой репозиторий по умолчанию, если в `Podfile` есть хотя бы одна строка `source`, поэтому его нужно указать явно. Если строки `source` в `Podfile` уже есть, добавьте к ним только репозиторий Mindbox.

2. Установите поды (в React Native и Flutter — из папки `ios`):

    ```shell
    pod install
    ```

3. Обновите поды, когда переходите на новую версию SDK или плагина React Native или Flutter. Команда `pod install` оставляет версии из `Podfile.lock`, а после обновления плагина останавливается на конфликте версий.

    ```shell
    pod update Mindbox
    ```

    В React Native и Flutter, а также если расширения уведомлений используют под `MindboxNotifications`, обновите оба пода:

    ```shell
    pod update Mindbox MindboxNotifications
    ```

Предупреждение `Found multiple specifications` при установке — не ошибка: часть версий есть в обоих репозиториях, копии одинаковые.

## Если CocoaPods не находит версию Mindbox

Ошибка `CocoaPods could not find compatible versions for pod "Mindbox"` (или `"MindboxNotifications"`) заканчивается одной из строк:

```text
None of your spec sources contain a spec satisfying the dependency: `Mindbox (= X.Y.Z)`.
Specs satisfying the `Mindbox, Mindbox (= X.Y.Z)` dependency were found, but they required a higher minimum deployment target.
```

Обе строки означают, что CocoaPods не нашел нужную версию. Вторая строка упоминает минимальную версию iOS (deployment target), но может появиться и по тем же причинам, что и первая:

* в `Podfile` нет строки `source` с репозиторием подов Mindbox;
* локальная копия репозитория подов Mindbox устарела;
* `Podfile.lock` содержит старую версию.

Чтобы исправить ошибку:

1. Проверьте, что в начале `Podfile` есть обе строки `source` из раздела «Подключение репозитория».
2. Обновите поды, как в шаге 3 раздела «Подключение репозитория». Команда `pod update` обновит локальные копии репозиториев и `Podfile.lock`.
3. Если ошибка осталась, проверьте, что минимальная версия iOS в `Podfile` (`platform :ios`) не ниже требуемой SDK. Требования SDK — в статье [Mindbox SDK](https://developers.mindbox.ru/docs/mindbox-sdk#поддерживаемые-платформы).
