# Ручная установка Clout App через Xcode (бесплатный Apple ID) (https://clout.wtf/guide/ru/xcode-manual-install/) > **Note:** **Платный Apple Developer аккаунт ($99/год)** снимает все ограничения ниже и даёт Clout Uploader устанавливать Clout App автоматически — без Xcode. [Оформить →](https://developer.apple.com/programs/enroll/) Это запасной путь. Основной способ установки — [через App Store Connect API](https://clout.wtf/guide/ru/asc-api-guide/). На бесплатном Apple ID он недоступен, поэтому остаётся ручная сборка через Xcode — её и проходим ниже. *** ## Что понадобится > **Note:** > > | Требование | Детали | > | ---------------------- | --------------------------------------------- | > | Mac | macOS 14 Sonoma или новее | > | Xcode | Версия 15 или новее — бесплатно из App Store | > | Apple ID | Бесплатный или платный, с пройденной 2FA | > | iPhone | iOS 17 или новее, с Lightning / USB-C кабелем | > | Свободное место на Mac | \~15 ГБ (Xcode + сборка) | > **Warning:** **Windows-пользователям.** Xcode существует только на macOS — без Mac (или macOS VM) ручная подпись через Xcode невозможна. Sideloadly, AltStore и подобные инструменты **не подходят**: Clout App требует особого порядка подписи, который эти утилиты не поддерживают. Для бесплатной установки нужен Mac с Xcode. *** ## Ограничения бесплатного Apple ID > **Note:** > > | Ограничение | Что это значит на практике | > | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | > | Подпись живёт **7 дней** | Через 7 дней Clout App на iPhone перестанет запускаться. Решение: раз в неделю заново нажать `Product → Test` в Xcode — это 1–2 минуты. | > | Максимум **3 приложения** от одного Apple ID на устройство | Если на iPhone уже стоит 3 sideload-приложения, удалите одно перед установкой Clout App. | > | Один Apple ID = одна установка | Если у вас несколько iPhone, заведите разные Apple ID на каждое устройство — или сразу переходите на платный. | *** ## Установка по шагам 1. ### Подготовить iPhone 1. На iPhone откройте **Settings → Privacy & Security → Developer Mode** и включите тумблер. 2. iPhone попросит перезагрузиться — подтвердите. 3. После перезагрузки разблокируйте iPhone и нажмите **Turn On** в подтверждающем диалоге. *Зачем:* без Developer Mode iOS откажется запускать любое приложение, подписанное dev-сертификатом. 2. ### Добавить Apple ID в Xcode 1. Откройте Xcode → меню **Xcode → Settings → Accounts** (`⌘,`). 2. Нажмите `+` внизу слева → **Apple ID** → введите свой Apple ID и пароль. 3. После добавления в правой части появится **Personal Team** с вашим именем — это и есть бесплатная команда подписи. Если включена 2FA — Apple пришлёт код на ваше доверенное устройство, введите его. 3. ### Скачать проект Clout App 1. В Clout Uploader откройте вкладку **Devices**. 2. Раскройте секцию **Sign via Xcode Manually**. 3. Нажмите **Download Xcode Project** — ZIP-архив скачается в папку Загрузок. 4. Распакуйте архив двойным кликом. 4. ### Открыть проект в Xcode 1. Внутри распакованной папки найдите файл `RodmanRunner.xcodeproj`. 2. Откройте его двойным кликом — Xcode загрузит проект. 3. Подождите, пока Xcode проиндексирует файлы (внизу строка статуса перестанет показывать прогресс). 5. ### Выбрать команду для подписи Важно Самое частое место, где спотыкаются — это нужно сделать для **обоих таргетов** проекта. 1. В левой панели нажмите на синюю иконку проекта **RodmanRunner** (самый верхний элемент дерева). 2. В центральной панели вверху выберите вкладку **Signing & Capabilities**. 3. В списке таргетов выберите **первый таргет**: * Убедитесь, что **Automatically manage signing** включено. * В выпадающем списке **Team** выберите свою **Personal Team (Free)**. 4. Перейдите к **второму таргету** и повторите то же самое — Team должна быть та же. #### Если появилась ошибка «Bundle ID is not available» или похожая Бесплатные Apple ID не могут использовать bundle ID, который уже занят другим пользователем. Решение: 1. Перейдите на вкладку **General** (рядом с Signing & Capabilities). 2. В поле **Bundle Identifier** поставьте уникальное значение в формате `com..RodmanRunner` — вместо `` подставьте любую короткую случайную строку (например, `com.k7m2p9.RodmanRunner`). 3. Сделайте это для **обоих таргетов** — bundle ID второго должен иметь префикс первого (Xcode подскажет, если нет). 6. ### Подключить iPhone 1. Подключите iPhone к Mac кабелем. 2. На iPhone появится диалог **«Trust This Computer?»** — нажмите **Trust** и введите код-пароль устройства. Иногда iOS этот диалог не показывает — это нормально, значит этот Mac уже считается доверенным. 3. В Xcode в верхней панели нажмите на выпадающий список устройств рядом со схемой (там может быть «Any iOS Device» или название симулятора). 4. В разделе **iOS Device** выберите **ваш iPhone**. Если iPhone не появляется в списке — переподключите кабель, разблокируйте iPhone или перезапустите Xcode. 7. ### Собрать и установить 1. В меню Xcode выберите **Product → Test** (или нажмите `⌘U`). 2. Xcode начнёт сборку — обычно 30–60 секунд. 3. В процессе на iPhone могут появляться диалоги — оставьте телефон разблокированным и не отключайте кабель. 4. Когда сборка завершится, Xcode попытается запустить тест на iPhone — **это нормально, что тест «упадёт» с ошибкой через несколько секунд**. Главное — приложение установилось. Меню Xcode: откройте Product и выберите пункт Test *Product → Test в меню Xcode (или ⌘U).* 8. ### Доверить разработчика на iPhone После первой установки iPhone не доверяет dev-сертификату — нужно разрешить вручную. 1. На iPhone откройте **Settings → General → VPN & Device Management**. 2. В разделе **Developer App** нажмите на строку с вашим Apple ID. 3. Нажмите **Trust «»** и подтвердите. 4. Найдите на главном экране иконку **RodmanRunner** и запустите её один раз — приложение откроется на белом/чёрном экране, это нормально. 5. Закройте приложение (свайп вверх). *Пустой экран — это нормально.* У Clout App нет собственного интерфейса: это только обёртка, через которую Clout Uploader управляет TikTok и автоматизирует действия на телефоне. После этого одноразового запуска приложение больше открывать не нужно — дальше всё ведёт Clout Uploader. 9. ### Проверить в Clout Uploader 1. Вернитесь в Clout Uploader, вкладка **Devices**. 2. Нажмите кнопку обновления — устройство появится в списке **Connected Devices** с зелёным индикатором, моделью iPhone и версией iOS, а справа — зелёный бейдж **Clout App (iOS)**. 3. Запустите тестовый thread — если поехал, установка прошла успешно. Список Connected Devices в Clout Uploader: в каждой строке — название устройства, модель iPhone, версия iOS, UDID и зелёный бейдж Clout App (iOS) с кнопкой Reinstall справа *Список Connected Devices с установленным Clout App (iOS) на пяти iPhone.* *** ## Что делать каждые 7 дней Подпись на бесплатном Apple ID живёт **ровно 7 дней**. Когда срок подойдёт к концу, Clout App перестанет запускаться — Clout Uploader покажет ошибку подключения к Clout App. **Как обновить подпись (1–2 минуты):** 1. Подключите iPhone к Mac. 2. Откройте тот же `RodmanRunner.xcodeproj` в Xcode. 3. Выберите iPhone в списке устройств. 4. Нажмите **Product → Test** (`⌘U`). Xcode переподпишет приложение свежим сертификатом, и оно снова заработает на 7 дней. > **Note:** Устали от еженедельных обновлений? [Платный Apple Developer аккаунт](https://developer.apple.com/programs/enroll/) ($99/год) продлевает подпись до **одного года**, и Clout Uploader сам берёт на себя её обновление. *** ## Частые проблемы > **Note:** > > | Симптом | Что делать | > | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | > | «Could not launch RodmanRunner» / «Untrusted Developer» | Не сделан шаг 8 (Trust Developer). Settings → General → VPN & Device Management → подтвердите доверие. | > | «Failed to register bundle identifier» | Bundle ID занят. Вернитесь к шагу 5 и замените Bundle Identifier на уникальный. | > | «Maximum App ID limit reached» | Бесплатный Apple ID ограничен 10 уникальными App ID за 7 дней. Подождите неделю, используйте другой Apple ID или переходите на платный аккаунт. | > | Xcode не видит iPhone | Разблокируйте iPhone и подтвердите «Trust This Computer». Попробуйте другой USB-кабель — нужен data-кабель, не charge-only. В крайнем случае перезапустите Xcode и Mac. | > | «This device has reached the maximum number of installed apps» | На iPhone уже стоит 3 приложения, подписанных вашим бесплатным Apple ID. Удалите одно и попробуйте снова. | > | Сборка идёт долго или зависла | Обычная сборка — 30–60 секунд; на медленном Mac может растянуться до нескольких минут. Если прошло больше — закройте Xcode, удалите папку `~/Library/Developer/Xcode/DerivedData` и попробуйте снова. | *** ## Дополнительно * **Безопасность.** Clout App (iOS) — это локальный helper, который управляет TikTok на вашем iPhone по командам Clout Uploader. Наружу он данные не отправляет — обменивается ими только с Clout Uploader на вашем компьютере. * **На несколько iPhone.** Повторите шаги 6–8 для каждого устройства, не пересобирая проект. Один Apple ID = до 3 устройств одновременно. * **Переключение Apple ID.** Если вы сменили Apple ID, в Clout Uploader используйте кнопку **Switch developer account** в секции Devices — это очистит старый кеш подписи. ## Связанные гайды * [Подготовка устройств](https://clout.wtf/guide/ru/device-setup/) — одноразовая настройка хоста и iPhone, которую стоит сделать первой. * [Установка через App Store Connect API](https://clout.wtf/guide/ru/asc-api-guide/) — основной способ установки, как только перейдёте с бесплатного Apple ID. * [Upload mode](https://clout.wtf/guide/ru/upload-guide/) — запуск первой публикационной сессии, когда устройство уже готово.