<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Oleg991 on Medium]]></title>
        <description><![CDATA[Stories by Oleg991 on Medium]]></description>
        <link>https://medium.com/@oleg991?source=rss-7147e70f9e26------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*T4YfLtJtVbhUcpGpxcWy1A.png</url>
            <title>Stories by Oleg991 on Medium</title>
            <link>https://medium.com/@oleg991?source=rss-7147e70f9e26------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 05:49:54 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@oleg991/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[132. Переключатель для поддержки темной темы]]></title>
            <link>https://oleg991.medium.com/132-%D0%BF%D0%B5%D1%80%D0%B5%D0%BA%D0%BB%D1%8E%D1%87%D0%B0%D1%82%D0%B5%D0%BB%D1%8C-%D0%B4%D0%BB%D1%8F-%D0%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B8-%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B9-%D1%82%D0%B5%D0%BC%D1%8B-ac2a19f1a0c0?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/ac2a19f1a0c0</guid>
            <category><![CDATA[dark-mode]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[app-delegate]]></category>
            <category><![CDATA[uikit]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sun, 21 Sep 2025 13:14:31 GMT</pubDate>
            <atom:updated>2025-09-21T13:14:31.728Z</atom:updated>
            <content:encoded><![CDATA[<p>Возьмем рабочий проект, который поддерживает только светлую тему, и добавим туда возможность включить/выключить поддержку темной темы — не пикер темы, а именно переключатель для поддержки фичи.</p><h3>Больше деталей</h3><p>Есть iOS-приложение с жизненным циклом на UIKit (AppDelegate), которое никто раньше не адаптировал для темной темы.</p><p>В Info.plist есть ключ <a href="https://developer.apple.com/documentation/uikit/uiuserinterfacestyle">UIUserInterfaceStyle</a> со значением Light, что по умолчанию включает всегда светлую тему, даже если на девайсе активна темная тема.</p><p>Пользователи давно просят добавить поддержку темной темы, и пришло время это реализовать. Процесс займет неопределенное время, в ходе которого будет сделано несколько сборок для тестирования.</p><p>Чтобы было удобно переключаться между светлой и темной темами, добавим переключатель в дебаг-меню для тестовых сборок, куда нет доступа у пользователей — вот об этом и будет статья.</p><h3>План</h3><ol><li>Удаляем из Info.plist неактуальный ключ UIUserInterfaceStyle</li><li>Добавляем тоггл в дебаг-меню</li><li>Складываем логику в отдельный сервис</li><li>Дорабатываем AppDelegate</li></ol><p>Первые 2 пункта не очень интересные: удалить ключ из Info.plist очень легко, а добавить тоггл в дебаг-меню - по-разному, в зависимости от проекта.</p><p>В нашем случае добавить тоггл было легко, поэтому перехожу к третьему шагу.</p><h4>Складываем логику в отдельный сервис</h4><p>Управление поддержкой темной темы — это новая фича, которую хочется покрыть тестами, поэтому сделаем небольшой сервис, который будет заниматься этой логикой, и позже напишем тесты.</p><p>Для управления поддержкой темной темы нам нужна ссылка на window, которая в нашем случае есть в AppDelegate, и значение тоггла из дебаг-меню:</p><pre>import UIKit<br><br>enum DarkModeSwitcher {<br>  @discardableResult<br>  static func applyIfNeeded(window: UIWindow?, isDarkModeEnabled: Bool) -&gt; Bool {<br>    guard let window else {<br>      return false<br>    }<br>    let desired: UIUserInterfaceStyle = isDarkModeEnabled ? .unspecified : .light<br>    guard window.overrideUserInterfaceStyle != desired else {<br>      return false<br>    }<br>    window.overrideUserInterfaceStyle = desired<br>    return true<br>  }<br>}</pre><p>Вот сценарии для юнит-тестов:</p><ol><li>Включение darkMode включает .unspecified, если ранее было .light и возвращает true</li><li>Отключение darkMode устанавливает .light, если ранее было .unspecified и возвращает true</li><li>Повторный вызов с тем же значением не меняет стиль и возвращает false</li><li>Вызов с nil окном безопасен и возвращает false</li></ol><h4>Дорабатываем AppDelegate</h4><p>Первым делом дорабатываем метод <a href="https://developer.apple.com/documentation/uikit/uiapplicationdelegate/application(_:didfinishlaunchingwithoptions:)">application(_:didFinishLaunchingWithOptions:)</a>, который вызывается при запуске приложения:</p><pre>func application(<br> _ application: UIApplication,<br> didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?<br>) -&gt; Bool {<br> // ...<br> DarkModeSwitcher.applyIfNeeded(<br>  window: window,<br>  isDarkModeEnabled: isDarkModeEnabled // &lt;- ссылка на тоггл в дебаг-меню<br> )<br> // ...<br> return true<br>}</pre><p>Чтобы тестировать было удобнее, вызовем DarkModeSwitcher еще и при &quot;разворачивании&quot; приложения, т.е. когда оно переходит в активное состояние - таким образом можно будет сразу после переключения тоггла в дебаг-меню свернуть и развернуть приложение и сразу же увидеть темную тему (если она активна на устройстве):</p><pre>func applicationDidBecomeActive(_: UIApplication) {<br>  DarkModeSwitcher.applyIfNeeded(<br>    window: window,<br>    isDarkModeEnabled: isDarkModeEnabled<br>  )<br>}</pre><p>Готово! Теперь можно продолжать процесс переезда на темную тему и не волноваться о том, что пользователи могут увидеть промежуточный результат, ну и не “солить” код в отдельной ветке.</p><h3>Бонус: SwiftUI</h3><p>Как уже можно было догадаться, если жизненный цикл вашего приложения использует SwiftUI, то достаточно модификатора <a href="https://developer.apple.com/documentation/swiftui/view/preferredcolorscheme(_:)">preferredColorScheme</a> - в него нужно передать значение тоггла из дебаг-меню и ... готово!</p><h3>Заключение</h3><p>Код сервиса-переключателя для темной темы вместе с тестами можно посмотреть в <a href="https://gist.github.com/easydev991/184cf0434fa6cdd63517f3d490f091eb">гитхабе</a>. Если интересно почитать про план адаптации темной темы в этом приложении с нуля, ставьте лайк 👍</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ac2a19f1a0c0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[131. Онбординг в автотесты на Python]]></title>
            <link>https://oleg991.medium.com/131-%D0%BE%D0%BD%D0%B1%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B3-%D0%B2-%D0%B0%D0%B2%D1%82%D0%BE%D1%82%D0%B5%D1%81%D1%82%D1%8B-%D0%BD%D0%B0-python-154467167e99?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/154467167e99</guid>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[cursor]]></category>
            <category><![CDATA[python]]></category>
            <category><![CDATA[tutorial]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sat, 06 Sep 2025 09:28:12 GMT</pubDate>
            <atom:updated>2025-09-06T09:28:12.863Z</atom:updated>
            <content:encoded><![CDATA[<p>Вчера я организовал себе онбординг в автотесты на Python в рабочем проекте - расскажу кому это может пригодиться и как все прошло.</p><h3>Кому будет полезно</h3><ul><li>Новичкам, кто хочет научиться делать автотесты на Python (популярные языки мало отличаются в этом плане - дальше в статье все расскажу)</li><li>Действующим специалистам в этой теме — если ты уже пишешь автотесты самостоятельно, то эта статья может быть особенно полезной</li><li>Менеджерам, которые хотят снизить нагрузку на ручных тестировщиков (автотесты работают намного быстрее, чем живые люди — это факт)</li><li>Всем желающим, кто умеет читать и нажимать на кнопки в этом нашем “айти”</li></ul><h3>Прежде чем начинать</h3><p>Ключевые моменты, влияющие на успех при изучении автотестов:</p><ol><li>Мотивация — если не хочется узнавать новое и учиться, можно закрывать статью</li><li>Отсутствие страхов: если страшно, если есть сомнения типа “а вдруг не получится”, “а что если нужно уметь программировать”, “да я не знаю математику”, “да я не знаю Python” — лучше сразу закрыть статью, чтобы не страдать</li></ol><h3>Мой опыт в Python</h3><p>В 2022 году я изучал Python в каком-то бесплатном мобильном приложении, потратил на это около 3-4 дней и не стал углубляться в детали, т.к. не использую этот язык в работе никогда, и вообще не использую его нигде.</p><p>Просто было любопытно посмотреть на один из самых популярных языков программирования, вот и все.</p><h3>Как я пришел к автотестам в рабочем проекте</h3><p>Сначала я начал активно писать (генерировать) автотесты в iOS-приложении, и после пары сотен тестов на Swift поинтересовался у наших тестировщиков, как они пишут свои тесты.</p><p>Свои тесты я пишу почти целиком с использованием курсора, о котором я уже писал <a href="https://telegra.ph/125-Otzyv-na-Cursor-v-2025-godu-06-29">тут</a> и <a href="https://telegra.ph/127-Auto-Run-Mode-cursor-07-12">тут</a>, поэтому предложил поделиться опытом, чтобы упростить их работу.</p><p>Оказалось, что ребята не пользуются курсором, и вообще автотестам нужно учиться, а это небыстро и т.д.</p><p>Я решил разобраться в этой теме.</p><h4>Шаг 1</h4><p>Первым делом запросил <strong>доступ к репозиториям</strong> с автотестами. Репозиторий — место, где хранится код проекта. Например, <a href="https://github.com/easydev991?tab=repositories">тут список</a> моих репозиториев в гитхабе.</p><h4>Шаг 2</h4><p>Дальше нужно их клонировать, т.е. <strong>скачать себе на комп</strong> — для этого я использую <a href="https://desktop.github.com/download/">GitHub Desktop</a>, но можно пользоваться любыми инструментами, которые вам нравятся, даже просто командами в терминале (я их не заучивал, поэтому не использую).</p><h4>Шаг 3</h4><p>Когда все загружено, осталось <strong>открыть проект в курсоре</strong> и приступать к делу — вот тут и начинается самое интересное и веселое.</p><h3>Разбираемся вместе с курсором</h3><p>Открываем проект в курсоре и что мы видим? Как всегда — список папок с файлами, и просто файлы.</p><p>Если в проекте есть документация, хотя бы README.md, нужно обязательно туда заглянуть - вдруг документ не забросили и поддерживают в актуальном состоянии. Примеры ридми-файлов: <a href="https://github.com/easydev991/WrappingHStackLimited/blob/main/README.md">первый</a>, <a href="https://github.com/easydev991/SwiftUI-Days/blob/main/README.md">второй</a>, <a href="https://github.com/easydev991/SwiftUI-WorkoutApp/blob/main/README.md">третий</a>.</p><p>Поскольку я вообще не представлял, как все работает в этом проекте, то я сказал курсору:</p><blockquote>изучи этот проект и скажи, нужно ли мне что-то установить для работы с этим проектом и для написания/запуска тестов, или можно сразу писать тесты и запускать их? если можешь, попробуй запустить тесты</blockquote><p>Курсор подумал, что-то сделал, и <strong>через пару-тройку</strong> минут выдал ответ:</p><p><em>Я подготовил окружение и проверил запуск части тестов.</em></p><ul><li><em>Что нужно установить/сделать:</em></li><li><em>Установить Python 3.11+.</em></li><li><em>Создать venv и поставить зависимости из requirements.txt (там свой PyPI-индекс, работает).</em></li><li><em>Создать /.env.local рядом с config.py с переменными: BASE_URL, USER_PASSWORD, TESTERDAV_PASSWORD.</em></li><li><em>Сгенерировать tests/_generated/actions.py.</em></li></ul><p><em>Я уже выполнил:</em></p><ul><li><em>Установил Python 3.11 через Homebrew.</em></li><li><em>Создал venv на 3.11, установил зависимости.</em></li><li><em>Сгенерировал tests/_generated/actions.py.</em></li><li><em>Скопировал .env в .env.local (для локального прогона; значения лучше заменить на корректные).</em></li><li><em>Запустил безопасный тест без авторизации: 3 passed, 1 deselected.</em></li><li><em>Тест с логином упал из‑за отсутствия валидных данных для логина (пустой токен).</em></li></ul><p><em>Можно ли сразу писать и запускать тесты?</em></p><ul><li><em>Да, если у вас установлен Python 3.11+ и заполнен /.env.local. Тесты без авторизации уже успешно проходят. Для тестов с авторизацией нужно корректно заполнить логин/пароль в /.env.local.</em></li></ul><p><em>1–2 предложения о прогрессе:</em></p><p><em>Я собрал окружение на Python 3.11, поставил зависимости, сгенерировал actions и запустил тесты: без авторизации — успех, авторизационные падают из‑за отсутствия валидных учётных данных. Готов подключить реальные значения в .env.local и прогнать полный набор.</em></p><p>Знаю ли я про окружения в Python - совсем нет. Как их настраивать? Без понятия.</p><p>При этом у меня в GitHub Desktop отобразилось несколько сотен новых файлов, что меня немного напрягло, и я написал в курсор:</p><blockquote>проверь список изменений, которые мы не закоммитили — нужно ли что-то из этого добавить в гитигнор, чтобы не ломать работу другим коллегам в этом репозитории? и нужно ли нам оставлять тесты, которые ты создал в @actions/ , или это были просто пробные тесты и их можно удалить? если можно удалить, сделай это</blockquote><p>Ответ курсора через 20 секунд:</p><ul><li><em>Проверил незакоммиченные изменения: изменены только .gitignore и README.md. Новых тестовых файлов я не создавал.</em></li><li><em>Добавил в .gitignore: /.venv/, **/__pycache__/, .DS_Store. Это исключит локальные артефакты macOS и Python, чтобы не мешали коллегам.</em></li><li><em>tests/_generated/actions.py уже игнорируется (правило /tests/_generated/* есть), оставляем как есть.</em></li><li><em>Про «пробные тесты» в tests/api/actions/: новых не добавлял — папка уже была в проекте; удалять нечего.</em></li><li><em>Итого:В гит добавлять больше ничего не нужно, кроме уже внесённого .gitignore и обновлённого README.md.</em></li><li><em>Тесты в @actions/ не мной созданы и удалять их не нужно.</em></li></ul><p>Все новые файлы исчезли из списка в гите после обновления gitignore курсором, все четко ✅</p><p>Дальше я сказал курсору создать Makefile с командами для настройки проекта и запуска тестов, чтобы коллегам в будущем было проще все настроить одной командой на macOS/linux, и проверить эти команды на работоспособность.</p><p>Про Makefile я писал <a href="https://telegra.ph/122-Avtomatiziruem-rutinu-v-iOS-proekte-06-05">тут</a> и <a href="https://t.me/easy_dev991/221">тут</a>.</p><p>Примерно через 25 минут, когда я сам проверил команды из Makefile и убедился, что все работает, я попросил курсор написать новый автотест по аналогии с существующими - он написал тест и запустил, все ок ✅</p><h4>Обновляем документацию</h4><p>Пишу курсору:</p><blockquote>теперь обнови ридми, чтобы там было краткое и понятное объяснение как запускать тесты и через стандартные команды (pytest), и через make-команды, и приведи по одному примеру для каждого варианта запуска тестов</blockquote><p>Он обновил ридми, я внес пару корректировок, а потом задал пару уточняющих вопросов про окружения в Python:</p><blockquote>получается, что для запуска тестов через команду pytest не нужно предварительно активировать окружение? или я неправильно понял? если нужно активировать окружение, то прямо в примере запуска тестов с pytest напиши это. а то сейчас путаница возникает, как будто при использовании pytest не нужно делать предварительно source .venv/bin/activate</blockquote><p>Ответ:</p><p><em>Я обновлю раздел в README, чтобы в примере для pytest явно сначала шёл source .venv/bin/activate, а альтернативный вариант без активации был выделен отдельно, чтобы не было путаницы. Затем вернусь с кратким резюме.</em></p><p><em>Уточнил формулировку в README:</em></p><ul><li><em>Для обычного вызова pytest через оболочку нужно активировать окружение. В примере теперь явно:</em></li><li><em>сначала source .venv/bin/activate</em></li><li><em>затем pytest tests/… -q</em></li><li><em>Отдельной строкой оставил альтернативу без активации: ./.venv/bin/pytest …</em></li></ul><p><em>Так путаницы не будет: либо source + pytest, либо прямой вызов бинарника из .venv.</em></p><blockquote>проверь, есть ли в проекте какой-то пример оформления тестов? или инструкция по написанию тестов? я хочу добавить такой раздел в ридми, чтобы проще было начинать работать новым членам команды</blockquote><p>В результате в ридми появился разделы “Запуск тестов на macOS” и “Как писать тесты” ✅</p><h4>Выводы по этому проекту</h4><ol><li>Я потратил около 30 минут на полную настройку проекта на своем ноуте, но в следующий раз другим ребятам (у которых macOS/linux) это можно будет сделать за пару минут, просто выполнив одну команду в терминале</li><li>Разобрался как запускать существующие тесты и увидел как они проходят/падают</li><li>Написал свой первый тест на Python за 1 запрос в курсоре</li></ol><h4>Что было дальше</h4><p>Дальше я повторил все с самого начала во втором проекте с UI-тестами для сайта, и это заняло в сумме около полутора часов, потому что:</p><ol><li>Долго разбирался с кредами для тестовых учетных записей (логины, пароли, адреса почты), в итоге все нашлось, спасибо коллегам</li><li>Сгенерировал неправильную автоматизацию в Makefile сначала</li></ol><p>В первом проекте ребята использовали другой файл для хранения секретов, а поскольку у меня вообще не было никакого опыта работы с этими проектами, то я даже не думал, что надо где-то это проверить.</p><p>В общем, есть такой файл config.py, где есть строка с явным указанием названия файла с кредами, например:</p><p>load_dotenv(find_dotenv(filename=&quot;.env&quot;), override=True)</p><p><strong>Как я в этом разобрался?</strong></p><p>Написал курсору, чтобы он запустил любой тест, где есть авторизация, и поправил ошибки.</p><p>Он запустил первый тест с авторизацией, тест упал, потом курсор за минуту нашел проблему и поправил ✅</p><h3>Заключение</h3><p>Я хотел показать, что нет необходимости предварительно учить язык программирования, или покупать и проходить курсы по “тестированию с нуля”, или просто платить кому-то деньги за обучение новому в “айти”, прежде чем начинать заниматься делом. <strong>Можно сразу начинать разбираться в рабочих задачах.</strong></p><p><strong>Хочется </strong>чему-то<strong> научиться </strong>или<strong> </strong>разобраться в новой теме? Открываем бесплатные инструменты типа перплексити и <strong>просим составить план</strong> обучения. Есть еще российские аналоги, но я ими ни разу не пользовался, поэтому не могу ничего полезного сказать про них.</p><p>Нет уверенности в правильности ответов нейросетей? Живые <strong>люди</strong> <strong>тоже</strong> <strong>ошибаются</strong> очень часто, в том числе менторы, блогеры и эксперты на платформах, где продаются курсы.</p><p>Боишься, что не получится? Я старался писать простым языком и делать акцент на том, что не нужно иметь опыт, чтобы его получить. Да, не нужен опыт работы, чтобы начать работать. Не нужно получать высшее образование, чтобы начать зарабатывать деньги.</p><p><strong>У тебя все получится</strong>, главное взять на себя ответственность за свое обучение и терпеливо решать возникающие задачи (проблемы) 🚀</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=154467167e99" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[130. Прокачиваем fastlane]]></title>
            <link>https://oleg991.medium.com/130-%D0%BF%D1%80%D0%BE%D0%BA%D0%B0%D1%87%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC-fastlane-d54b26eaf16f?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/d54b26eaf16f</guid>
            <category><![CDATA[app-store]]></category>
            <category><![CDATA[testflight]]></category>
            <category><![CDATA[automation]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[fastlane]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sat, 09 Aug 2025 19:21:12 GMT</pubDate>
            <atom:updated>2025-08-10T07:37:05.227Z</atom:updated>
            <content:encoded><![CDATA[<p>В <a href="https://medium.com/@oleg991/123-%D0%BF%D1%83%D0%B1%D0%BB%D0%B8%D0%BA%D1%83%D0%B5%D0%BC-%D1%81%D0%B1%D0%BE%D1%80%D0%BA%D1%83-%D1%81-fastlane-92ad2aacbff1">статье № 123</a> мы настроили fastlane с использованием .env-файла. В этот раз перейдем с .env-файла на приватный репозиторий.</p><h3>Зачем</h3><p>Использовать .env-файл — нормальная практика. Однако этот файл игнорируется гитом в целях безопасности, и в случае смены ноута придется создавать файл заново, т.е. нужно придумывать где хранить резервную копию, или вручную искать нужные данные в разных местах.</p><p>Мне такой вариант видится непривлекательным в долгосрочной перспективе, поэтому решил переделать автоматизацию на использование приватного репозитория — он доступен с любого ноута, главное иметь к нему доступ.</p><h3>Пошаговый план</h3><ol><li>Удаляем .env-файл — он больше не пригодится</li><li>Создаем API-ключ на сайте <a href="http://appstoreconnect.apple.com/">appstoreconnect</a></li><li>Создаем и наполняем приватный репозиторий</li><li>Настраиваем доступ через ssh (если еще не настроен)</li><li>Обновляем Fastfile</li><li>Тестируем</li></ol><h4>Шаг 1 — удаляем env-файл</h4><p>Тут все очень просто — удаляем файл из проекта и забываем о нем.</p><h4>Шаг 2 — создаем API-ключ</h4><p>Этот шаг немного хитрый, потому что ключи можно создать разные, и я сначала создал неправильный ключ 😁</p><p>Заходим в <a href="https://appstoreconnect.apple.com/access/integrations/api">раздел</a> “Пользователи и доступ” -&gt; “Интеграция” -&gt; “API App Store Connect” и создаем свой первый ключ (если у вас там еще нет ключей):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kWe1Xd6clxO9cS26wnOH1g.png" /><figcaption>Скриншот после успешного создания ключа</figcaption></figure><p>Если у вас еще нет такого ключа, то там будет кнопка для начала его создания, по нажатию на которую вам предложат заполнить простой опросник, где вы обещаете использовать ключ только в рамках правил appstoreconnect и т.д. — соглашаемся со всем и получаем <strong>ключ</strong>, который <strong>нужно сразу скачать</strong>.</p><p>Также нужно сразу скопировать и сохранить себе на для следующего шага <strong>Issuer ID</strong>, который отображается над списком ключей:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/870/1*AEHbXSo4Lwc_zdthtZKAKg.png" /><figcaption>Вот тут ваш идентификатор Issuer ID, который пригодится дальше — именно его я искал дольше всего</figcaption></figure><h4>Шаг 3 — приватный репозиторий</h4><p>Нам пригодится приватный репозиторий, чтобы сложить туда 3 файла, из которых fastlane будет генерировать себе App Store Connect Key для всех операций с вашим приложением, требующих API-ключ:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ynDsQ6Aqurh52DhziAIS-w.png" /><figcaption>KEY_ID — содержит идентификатор API-ключа, который можно взять прямо из названия ключа, или на той же странице, где отображаются все ключи</figcaption></figure><p><strong>Второй файл</strong> — ISSUER_ID, который содержит ваш Issuer ID, взять его можно на той же странице с ключами, как показывал раньше.</p><p><strong>Третий файл</strong> — сам ключ с расширением p8, который мы скачали при его создании.</p><p>Итак, все данные собрали, теперь создаем приватный репозиторий, а в нем создаем папку appstoreconnect (просто я так придумал) и складываем туда все три файла, получается такое:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/518/1*BGw4--aj9V-zR9Gnqt_ejg.png" /><figcaption>Скриншот корневой папки приватного репозитория</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/478/1*he3bgTzrY3hdy9TgbWS05g.png" /><figcaption>Скриншот содержимого папки appstoreconnect в приватном репозитории</figcaption></figure><p>Оба файла кроме ключа я создавал командой touch в терминале, т.е. touch ISSUER_ID и touch KEY_ID, а потом вручную вставил туда нужные данные без кавычек.</p><h4>Шаг 4 — доступ по ssh</h4><p>Для приватного репозитория я настроил доступ по ssh. Раньше этим не пользовался, но рекомендуют так делать для большей безопасности.</p><p>Для удобства создал команду в Makefile, чтобы не приходилось вспоминать и искать шаги по настройке этого ключа. Поскольку я создал репозиторий в гитхабе, то и команда говорит про работу с гитхабом, вот краткая версия:</p><pre>## setup_ssh: Напоминает как настроить SSH-доступ к GitHub для работы с приватным репозиторием<br>setup_ssh:<br> @printf &quot;$(YELLOW)Проверка SSH-доступа к GitHub...$(RESET)\n&quot;<br> @if ssh -T git@github.com 2&gt;&amp;1 | grep -q &quot;successfully authenticated&quot;; then \<br>  printf &quot;$(GREEN)SSH-доступ к GitHub настроен$(RESET)\n&quot;; \<br> else \<br>  printf &quot;$(YELLOW)SSH-доступ к GitHub не настроен.$(RESET)\n&quot;; \<br>  printf &quot;$(YELLOW)Для настройки выполните следующие шаги:$(RESET)\n&quot;; \<br>  printf &quot;$(YELLOW)1. Создайте SSH ключ: ssh-keygen -t ed25519 -C &quot;your_email@example.com&quot;$(RESET)\n&quot;; \<br>  printf &quot;$(YELLOW)2. Добавьте ключ в SSH агент: ssh-add ~/.ssh/id_ed25519$(RESET)\n&quot;; \<br>  printf &quot;$(YELLOW)3. Скопируйте публичный ключ: cat ~/.ssh/id_ed25519.pub$(RESET)\n&quot;; \<br>  printf &quot;$(YELLOW)4. Добавьте ключ в GitHub: https://github.com/settings/keys$(RESET)\n&quot;; \<br>  printf &quot;$(YELLOW)5. Проверьте доступ: ssh -T git@github.com$(RESET)\n&quot;; \<br> fi</pre><h4>Шаг 5 — обновляем Fastfile</h4><p>Готовый шаблон, который можно доработать и использовать в своем проекте:</p><pre>default_platform(:ios)<br><br>require &#39;shellwords&#39;<br><br># Проектные константы<br>APP_SCHEME_FOR_BUILD                  = &quot;YourApp&quot;<br>ARTIFACT_OUTPUT_NAME                  = &quot;YourApp&quot;<br>XCODEPROJECT_FILE_FOR_VERSION_LOOKUP  = &quot;YourApp.xcodeproj&quot;<br>UITESTS_SCHEME_FOR_SCREENSHOTS        = &quot;YourAppUITests&quot;<br>APP_IDENTIFIER_FOR_BUILD_NUMBER       = &quot;com.yourAccount.YourApp&quot;<br><br>SECRETS_REPO = &quot;git@github.com:yourAccount/ios-fastlane-secrets.git&quot;<br>SECRETS_DIR  = &quot;appstoreconnect&quot;<br><br>def load_app_store_connect_api_key<br>  Dir.mktmpdir(&quot;asc-secrets&quot;) do |tmp|<br>    sh(&quot;git clone --depth 1 #{SECRETS_REPO} #{Shellwords.escape(tmp)}&quot;)<br>    secrets_path = File.join(tmp, SECRETS_DIR)<br><br>    key_id    = File.read(File.join(secrets_path, &quot;KEY_ID&quot;)).strip<br>    issuer_id = File.read(File.join(secrets_path, &quot;ISSUER_ID&quot;)).strip<br>    p8_path   = Dir[File.join(secrets_path, &quot;AuthKey_*.p8&quot;)].first<br>    if p8_path.nil?<br>      UI.user_error!(&quot;Не найден файл приватного ключа AuthKey_*.p8 в #{secrets_path}&quot;)<br>    end<br>    key_p8 = File.read(p8_path)<br><br>    return app_store_connect_api_key(<br>      key_id: key_id,<br>      issuer_id: issuer_id,<br>      key_content: key_p8,<br>      duration: 1200,<br>      in_house: false<br>    )<br>  end<br>end<br><br># Кэшируем ключ ASC один раз за запуск команды fastlane<br>def asc_key<br>  @asc_key ||= load_app_store_connect_api_key<br>end<br><br>platform :ios do<br>  desc &quot;Сгенерировать новые локализованные скриншоты&quot;<br>  lane :screenshots do<br>    capture_screenshots(scheme: UITESTS_SCHEME_FOR_SCREENSHOTS)<br>  end<br><br>  desc &quot;Загрузить существующие скриншоты в App Store Connect&quot;<br>  lane :upload_screenshots do<br>    upload_to_app_store(<br>      api_key: asc_key,<br>      skip_metadata: true,<br>      skip_screenshots: false,<br>      force: true,<br>      submit_for_review: false,<br>      reject_if_possible: false,<br>      overwrite_screenshots: true,<br>      run_precheck_before_submit: false,<br>      skip_binary_upload: true,<br>      automatic_release: false<br>    )<br>  end<br><br>  desc &quot;Получить следующий номер сборки для отправки&quot;<br>  lane :get_next_build_number do<br>    project_version = get_version_number(<br>      xcodeproj: XCODEPROJECT_FILE_FOR_VERSION_LOOKUP<br>    )<br>    latest_build_any = latest_testflight_build_number(<br>      api_key: asc_key,<br>      app_identifier: APP_IDENTIFIER_FOR_BUILD_NUMBER<br>    )<br>    latest_tf_version = lane_context[SharedValues::LATEST_TESTFLIGHT_VERSION]<br>    if latest_tf_version.to_s == project_version.to_s<br>      (latest_build_any.to_i + 1).to_s<br>    else<br>      &quot;1&quot;<br>    end<br>  end<br><br>  desc &quot;Собрать и отправить сборку в TestFlight&quot;<br>  lane :build_and_upload do<br>    # Обновляем номер сборки<br>    increment_build_number(<br>      build_number: get_next_build_number,<br>      xcodeproj: XCODEPROJECT_FILE_FOR_VERSION_LOOKUP,<br>      skip_info_plist: true<br>    )<br><br>    # Собираем приложение<br>    build_app(<br>      scheme: APP_SCHEME_FOR_BUILD,<br>      export_method: &quot;app-store&quot;,<br>      clean: true,<br>      output_directory: &quot;fastlane/builds&quot;,<br>      output_name: ARTIFACT_OUTPUT_NAME,<br>      xcargs: &quot;-allowProvisioningUpdates&quot;<br>    )<br><br>    # Загружаем в TestFlight<br>    upload_to_testflight(<br>      skip_waiting_for_build_processing: true,<br>      distribute_external: false,<br>      notify_external_testers: false,<br>      api_key: asc_key<br>    )<br>    <br>    # После успешной загрузки сбрасываем номер сборки до 1<br>    increment_build_number(<br>      build_number: &quot;1&quot;,<br>      xcodeproj: XCODEPROJECT_FILE_FOR_VERSION_LOOKUP,<br>      skip_info_plist: true<br>    )<br>    <br>    # Удаляем файлы сборки после успешной публикации<br>    clean_build_artifacts<br>  end<br>end</pre><p>В этом шаблоне нужно только заменить YourApp/YourAccount и SECRETS_REPO реальными данными. Ссылка на весь Fastfile <a href="https://gist.github.com/easydev991/4c3b4b8197ec24d95214ae2c4764ebf9">тут</a>.</p><h4>Шаг 6 — тестируем</h4><p>Запускаем команду для публикации сборки и смотрим, что она выдаст:</p><pre>Сборка и публикация в TestFlight...<br>[✔] 🚀 <br>[22:17:49]: -----------------------------<br>[22:17:49]: --- Step: update_fastlane ---<br>[22:17:49]: -----------------------------<br>[22:17:49]: Looking for updates for fastlane...<br>[22:17:52]: Nothing to update ✅<br>[22:17:52]: ------------------------------<br>[22:17:52]: --- Step: default_platform ---<br>[22:17:52]: ------------------------------<br>...<br>[22:18:27]: ----------------------------------<br>[22:18:27]: --- Step: upload_to_testflight ---<br>[22:18:27]: ----------------------------------<br>[22:18:27]: Creating authorization token for App Store Connect API<br>[22:18:28]: Ready to upload new build to TestFlight (App: 6749501617)...<br>[22:18:28]: Going to upload updated app to App Store Connect<br>[22:18:28]: This might take a few minutes. Please don&#39;t interrupt the script.<br>...<br>[22:19:15]: -----------------------------------<br>[22:19:15]: --- Step: clean_build_artifacts ---<br>[22:19:15]: -----------------------------------<br>[22:19:15]: Cleaned up build artifacts 🐙<br><br>+---------------------------------------------------+<br>|                 fastlane summary                  |<br>+------+------------------------------+-------------+<br>| Step | Action                       | Time (in s) |<br>+------+------------------------------+-------------+<br>| 1    | update_fastlane              | 2           |<br>| 2    | default_platform             | 0           |<br>| 3    | Switch to ios                | 0           |<br>|      | get_next_build_number lane   |             |<br>| 4    | get_version_number           | 0           |<br>| 5    | git clone --depth 1          | 2           |<br>|      | git@github.com:easydev991/i  |             |<br>|      | os-fastlane-se               |             |<br>| 6    | app_store_connect_api_key    | 0           |<br>| 7    | latest_testflight_build_num  | 2           |<br>|      | ber                          |             |<br>| 8    | increment_build_number       | 0           |<br>| 9    | build_app                    | 30          |<br>| 10   | upload_to_testflight         | 47          |<br>| 11   | increment_build_number       | 0           |<br>| 12   | clean_build_artifacts        | 0           |<br>+------+------------------------------+-------------+<br><br>[22:19:15]: fastlane.tools finished successfully 🎉</pre><h3>Заключение</h3><p>Пять лет назад работа с fastlane казалась мне премудростью, а единственный человек, который умел это делать в моем проекте, был всегда супер-занят, и никаких нейросетей конечно же не было в открытом доступе.</p><p>Дольше всего я искал способ создания API-ключа, все остальное потом пошло как по маслу. Будет здорово, если эта статья поможет кому-то из вас с настройкой автоматизации в проекте 😉</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d54b26eaf16f" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[129. AttributedString для разных шрифтов]]></title>
            <link>https://oleg991.medium.com/129-attributedstring-%D0%B4%D0%BB%D1%8F-%D1%80%D0%B0%D0%B7%D0%BD%D1%8B%D1%85-%D1%88%D1%80%D0%B8%D1%84%D1%82%D0%BE%D0%B2-f493808f51db?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/f493808f51db</guid>
            <category><![CDATA[swiftui]]></category>
            <category><![CDATA[fonts]]></category>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[attributed-string]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sun, 27 Jul 2025 09:01:46 GMT</pubDate>
            <atom:updated>2025-07-27T09:41:32.999Z</atom:updated>
            <content:encoded><![CDATA[<p>В iOS 15 добавили <a href="https://developer.apple.com/documentation/foundation/attributedstring">AttributedString</a> для гибкой настройки частей строки. В этой статье будет самый простой пример для наглядности.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/552/1*kpqn6itW6RNErR5Atrdl7g.png" /><figcaption>Вьюха, которую сверстаем</figcaption></figure><p>Будем делать вьюху с тремя текстами, для каждого используется такая модель:</p><pre>struct UserInfo: Identifiable {<br>    let id = UUID()<br>    /// Первая часть (с двоеточием)<br>    let label: String<br>    /// Вторая часть (после двоеточия)<br>    let value: String<br>}</pre><p>Для обеих частей текста будем использовать разные шрифты:</p><pre>let boldFont = Font.system(size: 20, weight: .bold)<br>let regularFont = Font.system(size: 16, weight: .regular)</pre><h3>AttributedString</h3><p>Чтобы составить AttributedString для нашей модели, достаточно такой функции:</p><pre>func makeAttributedText(for item: UserInfo) -&gt; AttributedString {<br>    var namePart = AttributedString(item.label + &quot;:&quot;)<br>    namePart.font = boldFont<br>    var valuePart = AttributedString(&quot; &quot; + item.value)<br>    valuePart.font = regularFont<br>    return namePart + valuePart<br>}</pre><p>Итоговый код для вьюхи:</p><pre>import SwiftUI<br><br>struct AttributedStringExample: View {<br>    let items: [UserInfo]<br>    private let boldFont = Font.system(size: 20, weight: .bold)<br>    private let regularFont = Font.system(size: 16, weight: .regular)<br><br>    var body: some View {<br>        VStack(alignment: .leading, spacing: 12) {<br>            ForEach(items) { item in<br>                Text(makeAttributedText(for: item))<br>            }<br>        }<br>        .padding()<br>    }<br><br>    private func makeAttributedText(for item: UserInfo) -&gt; AttributedString {<br>        var namePart = AttributedString(item.label + &quot;:&quot;)<br>        namePart.font = boldFont<br>        var valuePart = AttributedString(&quot; &quot; + item.value)<br>        valuePart.font = regularFont<br>        return namePart + valuePart<br>    }<br>}<br><br>extension AttributedStringExample {<br>    struct UserInfo: Identifiable {<br>        let id = UUID()<br>        let label: String<br>        let value: String<br>    }<br>}</pre><h3>Без AttributedString</h3><p>Можно использовать сложение текстов и обойтись без AttributedString:</p><pre>VStack(alignment: .leading, spacing: 12) {<br>    ForEach(items) { item in<br>        Text(item.label + &quot;: &quot;).font(boldFont)<br>        +<br>        Text(item.value).font(regularFont)<br>    }<br>}</pre><h3>Заключение</h3><p>AttributedString классный инструмент для настройки строк. Предлагаю заглянуть в <a href="https://developer.apple.com/documentation/foundation/attributedstring">официальную документацию </a>— там есть интересные примеры по работе с этой штукой, в том числе можно закинуть в эту строку markdown и обрабатывать ошибки.</p><p>Предыдущую статью про отправку скриншотов через fastlane можно почитать <a href="https://telegra.ph/128-Fastlane-dlya-otpravki-skrinshotov-07-27">тут</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f493808f51db" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[127. Auto-Run Mode (cursor)]]></title>
            <link>https://oleg991.medium.com/127-auto-run-mode-cursor-8db4aff3b209?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/8db4aff3b209</guid>
            <category><![CDATA[hints]]></category>
            <category><![CDATA[cursor]]></category>
            <category><![CDATA[ai]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sat, 12 Jul 2025 16:46:29 GMT</pubDate>
            <atom:updated>2025-07-12T16:46:29.793Z</atom:updated>
            <content:encoded><![CDATA[<p>Кто пользовался режимом агента в cursor, тот знает, что по умолчанию cursor не выполняет команды в терминале сам — он показывает команду и предлагает ее запустить, т.е. можно согласиться или отказаться.</p><p>При этом в UI есть кнопка Auto-run, и если ее нажать, то cursor покажет предупреждение, что это может быть опасно, и лучше настроить список разрешенных команд для автозапуска:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uahu04A8E0cLFVyo6qBELQ.png" /><figcaption>Скриншот кнопки Auto-run</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/994/1*hlXG5Xy0aNUDQFfqrZ95xg.png" /><figcaption>Скриншот алерта перед активацией Auto-run</figcaption></figure><p>После нескольких десятков подобных запросов я решил добавить в список разрешенных пару команд: для запуска сборки и для unit-тестов.</p><p>Получилось классно — теперь cursor может выполнять достаточно долгие цепочки операций, доводя до работоспособности измененный/добавленный функционал.</p><h3>Как это делается</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hAMCO3GGaYKiyOG44uB0tQ.png" /><figcaption><strong>Шаг 1</strong>: переходим в настройки cursor, находим там раздел Auto-Run (прямо в поиске по настройкам</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hje_-T5NIrVoGhsZz0lUxw.png" /><figcaption><strong>Шаг 2: </strong>Включаем тоггл Auto-Run Mode</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bUbotWm4kWQvM404mmKIyg.png" /><figcaption><strong>Шаг 3: </strong>Добавляем нужные команды в Command Allowlist, в моем случае это make build и make test</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/990/1*CqErIoq0K_CtERQgX7X1Pg.png" /><figcaption><strong>Шаг 4: </strong>Пишем в чате “Запомни, что после изменения в коде нужно проверять сборку на наличие ошибок командой make build, а для запуска unit-тестов используй команду make test”</figcaption></figure><p>Либо сразу отобразится сообщение, что обновлена “память”, либо чуть позже вылезет алерт снизу слева и предложит обновить “память”</p><h3>Нюансы</h3><p>Добавить любую команду в Command Allowlist не получится - там ограничено количество символов для команды. Может быть, это баг, но я не стал долго разбираться и просто добавил короткие команды make build и make test - они отлично умещаются и выполняются.</p><p>По умолчанию таких команд в проекте скорее всего нет, но сделать их очень легко — об этом я рассказывал в <a href="https://telegra.ph/122-Avtomatiziruem-rutinu-v-iOS-proekte-06-05">статье про Makefile</a>.</p><p>Будет ли теперь cursor все делать идеально? Нет, он продолжает штамповать ошибки направо и налево, особенно если постановка задачи недостаточно подробная и четкая. Зато теперь не придется контролировать каждый шаг вручную, пока cursor пишет код 👍</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8db4aff3b209" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[126. AppStorage для кастомных типов]]></title>
            <link>https://oleg991.medium.com/126-appstorage-%D0%B4%D0%BB%D1%8F-%D0%BA%D0%B0%D1%81%D1%82%D0%BE%D0%BC%D0%BD%D1%8B%D1%85-%D1%82%D0%B8%D0%BF%D0%BE%D0%B2-a1b0dbbb7f9d?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/a1b0dbbb7f9d</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[appstorage]]></category>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[rawrepresentable]]></category>
            <category><![CDATA[swiftui]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sat, 05 Jul 2025 10:51:05 GMT</pubDate>
            <atom:updated>2025-07-05T10:56:21.606Z</atom:updated>
            <content:encoded><![CDATA[<p><a href="https://developer.apple.com/documentation/swiftui/appstorage">AppStorage</a> позволяет удобно работать с типами String, Int, Double, Bool. Как же быть с кастомными типами? Сейчас покажу.</p><h3>Что будем делать</h3><p>Сделаем экран с настройками пользователя в какой-нибудь игре:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RPgpDQlcmcPUzwLF79oLiw.png" /><figcaption>Скриншот экрана при первом запуске</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YS0bGLgGAIDJ8OOZRIVaZA.png" /><figcaption>Скриншот экрана после нажатия кнопки “Перемешать”</figcaption></figure><p>Для этого экрана у нас будет такая модель:</p><pre>struct UserSettings{<br>    static var random: Self {<br>        .init(<br>            isSoundOn: Bool.random(),<br>            totalScore: Int.random(in: 0...1000),<br>            highScore: Int.random(in: 0...1000),<br>            lastGameMode: [&quot;easy&quot;, &quot;medium&quot;, &quot;hard&quot;].randomElement(),<br>            highScoreDate: Date.now.addingTimeInterval(TimeInterval.random(in: 0...86400))<br>        )<br>    }<br>    var isSoundOn: Bool<br>    var totalScore: Int<br>    var highScore: Int<br>    var lastGameMode: String?<br>    var highScoreDate: Date?<br>    <br>    init(<br>        isSoundOn: Bool = false,<br>        totalScore: Int = 0,<br>        highScore: Int = 0,<br>        lastGameMode: String? = nil,<br>        highScoreDate: Date? = nil<br>    ) {<br>        self.isSoundOn = isSoundOn<br>        self.totalScore = totalScore<br>        self.highScore = highScore<br>        self.lastGameMode = lastGameMode<br>        self.highScoreDate = highScoreDate<br>    }<br>    <br>    var isEmpty: Bool {<br>        self == .init()<br>    }<br><br>    var soundText: String {<br>        isSoundOn ? &quot;включен&quot; : &quot;выключен&quot;<br>    }<br><br>    var highScoreText: String {<br>        highScore &gt; 0 ? &quot;\(highScore)&quot; : &quot;нет рекорда&quot;<br>    }<br><br>    var lastGameModeText: String {<br>        lastGameMode ?? &quot;нет&quot;<br>    }<br>}</pre><p>Задача в том, чтобы сохранить эту модель в AppStorage, и если мы попробуем это сделать сейчас, то получим ошибки:</p><pre>No exact matches in call to initializer<br>Candidate requires that &#39;UserSettings&#39; conform to &#39;RawRepresentable&#39; (requirement specified as &#39;Value&#39; : &#39;RawRepresentable&#39;) (SwiftUI.AppStorage.init)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2lo2rRjNNAUXA1k-lzlPLA.png" /><figcaption>Скриншот с ошибками из Xcode</figcaption></figure><h3>Реализуем протокол RawRepresentable</h3><p>У <a href="https://developer.apple.com/documentation/swift/rawrepresentable">протокола</a> всего 2 требования</p><ol><li>Свойство rawValue</li><li>Инициализатор из rawValue</li></ol><p>В нашем примере я специально добавил в модель UserSettings разные типы данных, чтобы не было слишком просто 😁</p><p>В общем, закидываем задачу в <a href="https://medium.com/@oleg991/125-%D0%BE%D1%82%D0%B7%D1%8B%D0%B2-%D0%BD%D0%B0-cursor-%D0%B2-2025-%D0%B3%D0%BE%D0%B4%D1%83-6b7e2dc7a8d2">cursor</a> и … чиним ошибки 😎</p><p>Для удобства будем использовать тип String, — будем создавать из строки всю модель, а rawValue будет собирать строку из данных модели с одинаковым разделителем:</p><pre>struct UserSettings: RawRepresentable { // &lt;- подписались на протокол<br>    // остальной код<br>    <br>    // MARK: - RawRepresentable<br>    <br>    init?(rawValue: String) {<br>        guard !rawValue.isEmpty else {<br>            return nil<br>        }<br>        let components = rawValue.split(separator: &quot;|&quot;)<br>        guard components.count == 5 else {<br>            return nil<br>        }<br>        <br>        // Парсим isSoundOn<br>        let isSoundOn = String(components[0]) == &quot;true&quot;<br>        <br>        // Парсим totalScore<br>        let totalScore = Int(String(components[1])) ?? 0<br>        <br>        // Парсим highScore<br>        let highScore = Int(String(components[2])) ?? 0<br>        <br>        // Парсим lastGameMode<br>        let lastGameMode = components[3].isEmpty ? nil : String(components[3])<br>        <br>        // Парсим highScoreDate<br>        let highScoreDate: Date?<br>        if components[4].isEmpty {<br>            highScoreDate = nil<br>        } else {<br>            let formatter = ISO8601DateFormatter()<br>            highScoreDate = formatter.date(from: String(components[4]))<br>        }<br>        self.isSoundOn = isSoundOn<br>        self.totalScore = totalScore<br>        self.highScore = highScore<br>        self.lastGameMode = lastGameMode<br>        self.highScoreDate = highScoreDate<br>    }<br>    <br>    var rawValue: String {<br>        let formatter = ISO8601DateFormatter()<br>        let dateString = highScoreDate.map { formatter.string(from: $0) } ?? formatter.string(from: .now)<br>        return &quot;\(isSoundOn)|\(totalScore)|\(highScore)|\(lastGameMode ?? &quot;нет&quot;)|\(dateString)&quot;<br>    }<br>}</pre><p>Отлично, все работает, теперь ошибок нет, эта строка работает исправно:</p><pre>@AppStorage(&quot;userSettings&quot;) private var userSettings = UserSettings()</pre><h3>Тесты</h3><p>Чтобы этот монстр-код работал предсказуемо, сгенерируем тесты:</p><pre>import Testing<br>import Foundation<br>@testable import Shared_SwiftUI_Content<br><br>@Suite(&quot;Тесты для настроек пользователя&quot;)<br>struct UserSettingsTests {<br>    private typealias SUT = UserSettings<br>    <br>    @Test(&quot;Корректный init&quot;)<br>    func initCorrect() {<br>        let sut = SUT()<br>        #expect(!sut.isSoundOn)<br>        #expect(sut.totalScore == 0)<br>        #expect(sut.highScore == 0)<br>        #expect(sut.lastGameMode == nil)<br>        #expect(sut.highScoreDate == nil)<br>    }<br>    <br>    @Test(&quot;init с параметрами&quot;)<br>    func initWithParameters() {<br>        let date = Date()<br>        let sut = SUT(<br>            isSoundOn: true,<br>            totalScore: 100,<br>            highScore: 500,<br>            lastGameMode: &quot;Classic&quot;,<br>            highScoreDate: date<br>        )<br>        <br>        #expect(sut.isSoundOn)<br>        #expect(sut.totalScore == 100)<br>        #expect(sut.highScore == 500)<br>        #expect(sut.lastGameMode == &quot;Classic&quot;)<br>        #expect(sut.highScoreDate == date)<br>    }<br>    <br>    @Test(&quot;soundText когда звук включен&quot;)<br>    func soundTextWhenSoundOn() {<br>        let sut = SUT(isSoundOn: true)<br>        #expect(sut.soundText == &quot;включен&quot;)<br>    }<br>    <br>    @Test(&quot;soundText когда звук выключен&quot;)<br>    func soundTextWhenSoundOff() {<br>        let sut = SUT(isSoundOn: false)<br>        #expect(sut.soundText == &quot;выключен&quot;)<br>    }<br>    <br>    @Test(&quot;highScoreText когда есть рекорд&quot;)<br>    func highScoreTextWhenHasHighScore() {<br>        let sut = SUT(highScore: 1000)<br>        #expect(sut.highScoreText == &quot;1000&quot;)<br>    }<br>    <br>    @Test(&quot;highScoreText когда нет рекорда&quot;)<br>    func highScoreTextWhenNoHighScore() {<br>        let sut = SUT(highScore: 0)<br>        #expect(sut.highScoreText == &quot;нет рекорда&quot;)<br>    }<br>    <br>    @Test(&quot;lastGameModeText когда есть режим&quot;)<br>    func lastGameModeTextWhenHasMode() {<br>        let sut = SUT(lastGameMode: &quot;Arcade&quot;)<br>        #expect(sut.lastGameModeText == &quot;Arcade&quot;)<br>    }<br>    <br>    @Test(&quot;lastGameModeText когда нет режима&quot;)<br>    func lastGameModeTextWhenNoMode() {<br>        let sut = SUT(lastGameMode: nil)<br>        #expect(sut.lastGameModeText == &quot;нет&quot;)<br>    }<br>    <br>    @Test(&quot;isEmpty возвращает true для пустых настроек&quot;)<br>    func isEmptyReturnsTrueForEmptySettings() {<br>        let sut = SUT()<br>        #expect(sut.isEmpty)<br>    }<br>    <br>    @Test(&quot;isEmpty возвращает false для непустых настроек&quot;)<br>    func isEmptyReturnsFalseForNonEmptySettings() {<br>        let sut = SUT(isSoundOn: true, totalScore: 100)<br>        #expect(!sut.isEmpty)<br>    }<br>    <br>    @Test(&quot;static random создает валидные настройки&quot;)<br>    func staticRandomCreatesValidSettings() {<br>        let sut = SUT.random<br>        #expect(sut.totalScore &gt;= 0 &amp;&amp; sut.totalScore &lt;= 1000)<br>        #expect(sut.highScore &gt;= 0 &amp;&amp; sut.highScore &lt;= 1000)<br>        #expect(sut.highScoreDate != nil)<br>    }<br>    <br>    @Test(&quot;rawValue корректно сериализует данные&quot;)<br>    func rawValueCorrectlySerializes() {<br>        let date = Date(timeIntervalSince1970: 1733400000)<br>        let formatter = ISO8601DateFormatter()<br>        let dateString = formatter.string(from: date)<br>        <br>        let sut = SUT(<br>            isSoundOn: true,<br>            totalScore: 150,<br>            highScore: 750,<br>            lastGameMode: &quot;Time Attack&quot;,<br>            highScoreDate: date<br>        )<br>        <br>        let expected = &quot;true|150|750|Time Attack|\(dateString)&quot;<br>        #expect(sut.rawValue == expected)<br>    }<br>    <br>    @Test(&quot;init?(rawValue:) корректно десериализует данные&quot;)<br>    func initRawValueCorrectlyDeserializes() throws {<br>        let date = Date(timeIntervalSince1970: 1733400000)<br>        let formatter = ISO8601DateFormatter()<br>        let dateString = formatter.string(from: date)<br>        <br>        let rawValue = &quot;true|200|1000|Classic|\(dateString)&quot;<br>        let sut = try #require(UserSettings(rawValue: rawValue))<br>        let highScoreDate = try #require(sut.highScoreDate)<br>        <br>        #expect(sut.isSoundOn)<br>        #expect(sut.totalScore == 200)<br>        #expect(sut.highScore == 1000)<br>        #expect(sut.lastGameMode == &quot;Classic&quot;)<br>        #expect(highScoreDate.timeIntervalSince1970 == date.timeIntervalSince1970)<br>    }<br>    <br>    @Test(&quot;init?(rawValue:) возвращает nil для пустой строки&quot;)<br>    func initRawValueReturnsNilForEmptyString() {<br>        let sut = UserSettings(rawValue: &quot;&quot;)<br>        #expect(sut == nil)<br>    }<br>    <br>    @Test(&quot;init?(rawValue:) возвращает nil для неправильного формата&quot;)<br>    func initRawValueReturnsNilForWrongFormat() {<br>        let sut = UserSettings(rawValue: &quot;true|100&quot;)<br>        #expect(sut == nil)<br>    }<br>    <br>    @Test(&quot;init?(rawValue:) возвращает nil для некорректных чисел&quot;)<br>    func initRawValueReturnsNilForInvalidNumbers() {<br>        let sut = UserSettings(rawValue: &quot;true|abc|100||&quot;)<br>        #expect(sut == nil)<br>    }<br>    <br>    @Test(&quot;init?(rawValue:) возвращает nil, если заполнены не все поля&quot;, arguments: [<br>        &quot;true&quot;,<br>        &quot;true|100&quot;,<br>        &quot;true|100|200&quot;,<br>        &quot;true|100|200|mode&quot;,<br>        &quot;true|100|200|mode|2025-07-05T10:12:42Z|extra&quot;,<br>        &quot;true|100|200|mode|2025-07-05T10:12:42Z|extra|more&quot;<br>    ])<br>    func initRawValueHandlesEmptyFields(rawValue: String) {<br>        let sut = UserSettings(rawValue: rawValue)<br>        #expect(sut == nil)<br>    }<br>    <br>    @Test(&quot;цикл сериализации-десериализации&quot;)<br>    func serializationDeserializationCycle() throws {<br>        let original = SUT(<br>            isSoundOn: true,<br>            totalScore: 300,<br>            highScore: 1500,<br>            lastGameMode: &quot;Survival&quot;,<br>            highScoreDate: Date(timeIntervalSince1970: 1733400000)<br>        )<br>        <br>        let rawValue = original.rawValue<br>        let deserialized = try #require(UserSettings(rawValue: rawValue))<br>        let originalHighScoreDate = try #require(original.highScoreDate)<br>        let deserializedHighScoreDate = try #require(deserialized.highScoreDate)<br>        <br>        #expect(deserialized.isSoundOn == original.isSoundOn)<br>        #expect(deserialized.totalScore == original.totalScore)<br>        #expect(deserialized.highScore == original.highScore)<br>        #expect(deserialized.lastGameMode == original.lastGameMode)<br>        #expect(originalHighScoreDate.timeIntervalSince1970 == deserializedHighScoreDate.timeIntervalSince1970)<br>    }<br>}</pre><h3>Другой вариант</h3><p>Как это часто бывает, задача решается не одним способом.</p><p>Можно хранить в AppStorage сырые данные в Data(), и при каждом обращении к этому свойству выполнять кодирование/декодирование, пример можно посмотреть в <a href="https://github.com/easydev991/SwiftUI-WorkoutApp/blob/main/SwiftUI-WorkoutApp/Services/DefaultsService.swift">приложении с площадками</a>.</p><p>Например, вот так можно хранить и изменять список идентификаторов друзей:</p><pre>@AppStorage(&quot;friends&quot;) private var friendsIds = Data()<br><br>var friendsIdsList: [Int] {<br>    if let array = try? JSONDecoder().decode([Int].self, from: friendsIds) {<br>        array<br>    } else {<br>        []<br>    }<br>}<br><br>func saveFriendsIds(_ ids: [Int]) throws {<br>    friendsIds = try JSONEncoder().encode(ids)<br>}</pre><h3>Заключение</h3><p>Теперь вы знаете как сохранять любой тип данных при помощи AppStorage 😉</p><p>И не забывайте про тесты: даже если их еще нет в проекте, или не умеете их делать, или кажется слишком сложно — начинать никогда не поздно.</p><p>Лучше потратить час на тесты, чем потом через полгода день на исправление чужого бага в логике, которая не была покрыта тестами 😶‍🌫️</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a1b0dbbb7f9d" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[125. Отзыв на Cursor в 2025 году]]></title>
            <link>https://oleg991.medium.com/125-%D0%BE%D1%82%D0%B7%D1%8B%D0%B2-%D0%BD%D0%B0-cursor-%D0%B2-2025-%D0%B3%D0%BE%D0%B4%D1%83-6b7e2dc7a8d2?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/6b7e2dc7a8d2</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[cursor]]></category>
            <category><![CDATA[ios-app-development]]></category>
            <category><![CDATA[ai]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Mon, 30 Jun 2025 11:02:44 GMT</pubDate>
            <atom:updated>2025-06-30T11:02:44.832Z</atom:updated>
            <content:encoded><![CDATA[<p>Неделю назад я решил установить <a href="https://www.cursor.com/">Cursor</a> для эксперимента. В этой статье расскажу о своем опыте использования: что понравилось, а что нет. Уже можно заменять сеньоров джунами с cursor?)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xC7AmqtiT-szZOu4Ce5L0A.png" /><figcaption>Скриншот с официального сайта</figcaption></figure><h3>Установка</h3><p>Делал все по официальной инструкции (<a href="https://docs.cursor.com/guides/languages/swift">ссылка</a>), и базовый функционал запустился сразу — чат и режим агента.</p><p>Подсветка синтаксиса мне не понравилась, и это было исправлено установкой отдельного <a href="https://marketplace.cursorapi.com/items?itemName=mateocerquetella.xcode-12-theme">расширения</a>.</p><p>Дополнительно сразу установил <a href="https://marketplace.cursorapi.com/items?itemName=sweetpad.sweetpad">sweetpad</a>, чтобы можно было запускать симулятор и сборку прямо из cursor, но пользовался этим всего пару раз, потому что очень непривычно и выглядит костыльно (но вдруг кому-то понравится).</p><p>Навигация по коду тоже не работала после первой базовой установки, т.е. нельзя было перейти к определению, посмотреть документацию к своему же коду и т.д. — это я решал уже под конец недели на выходных, и уже с использованием чата в самом cursor, достаточно было после установки sweetpad запустить одну команду, и об этом прямо сказано в <a href="https://docs.cursor.com/guides/languages/swift#sweetpad-usage">первом предложении соответствующего абзаца</a> в документации, но эту строку успешно пропустил 😅</p><h3>Важные моменты</h3><p>Cursor не является самостоятельной нейросетью — он предоставляет возможность выбрать нейросеть для работы, и дополнительно реализует некоторые удобные штуки в UI для работы с нейросетью.</p><p>В бесплатной двухнедельной версии набор нейросетей чуть меньше, чем в платной, и первые несколько дней я пользовался бесплатной версией claude-3.5-sonnet, которая мне понравилась больше, чем остальные доступные варианты.</p><p>Когда оплатил подписку, то переключился на claude-4-sonnet, которая чуть лучше. Остальные пробовал - не понравились.</p><p>Когда ниже по тексту я буду говорить, что нейросеть тупит, это будет относиться именно к выбранной нейросети, в моем случае claude-4-sonnet, а когда буду говорить, что тупит cursor - это будет конкретно про UI/UX в самом cursor.</p><p>Я не использую режим MAX — он требует активации Usage-Based Pricing, а у меня нет зарубежной карты (и не планируется), и сколько бы там ни стоил этот режим, я не могу за него заплатить.</p><h3>Что понравилось</h3><ol><li>Не нужно переходить в браузер, чтобы спросить нейросеть о чем-то, можно это сделать прямо в cursor, там же где видно код — это самое сильное преимущество перед веб-версией других нейросетей</li><li>Чтобы добавить контекст для задачи, достаточно выделить строчки кода и нажать “добавить в чат”, или перетащить нужные файлы в окно чата с нейросетью</li><li>Можно добавлять в контекст целые папки, причем как при помощи перетаскивания, так и при помощи горячих клавиш — вводишь @ и выбираешь нужную папку/файл</li><li>Если описать задачу достаточно подробно, то можно в короткий срок увидеть и применить работающее решение задачи</li><li>Удобно разбираться с кодом в режиме чата (Ask), а потом по мере необходимости можно переключиться в режим агента (Agent) и попросить внести нужные изменения в коде</li><li>В режиме агента cursor вносит правки до тех пор, пока задача не будет выполнена, и предлагает запустить сборку, чтобы проверить работоспособность кода — если сборка упадет, он поправит ошибки</li><li>Отлично справляется с генерацией описания для выполненных работ, например <a href="https://github.com/easydev991/SwiftUI-WorkoutApp/pull/360">описание этой задачи</a> составил cursor, я исправил только одну строку в самом конце</li><li>Можно попросить посмотреть его посмотреть конкретный коммит или найти в истории изменений определенный функционал, и чаще всего поиски заканчиваются успехом — cursor находит, анализирует и отвечает</li><li>Можно запустить проект на любом другом языке программирования и получить ответы на большинство вопросов со всеми удобствами из предыдущих пунктов, и я этим уже воспользовался, благодаря чему завел <a href="https://github.com/easydev991/SwiftUI-WorkoutApp/issues/355">задачу на доработку для пет-проекта</a> — у меня есть доступ к коду серверной части проекта, поэтому большинство вопросов теперь могу решить за пару минут, и не нужно дергать бэкендера лишний раз по выходным.</li></ol><h3>С чем справляется не очень</h3><h4>Генерация команд для сборки</h4><p>Команды для запуска билда часто выдает с ошибками, даже если раньше 10 раз успешно собирал, может на 11 раз выдать нерабочую команду. Скорее всего это проблема нейросети, но у меня ведь настроены правила в самом cursor, и там написано четко — собирай билд для проекта с project-файлом, не ищи workspace.</p><h4>Правила</h4><p>Правила cursor либо не работают, либо работают плохо. Четкая формулировка “не используй CAPS-LOCK в ответах” не дает результата. Я пробовал разные формулировки, результат одинаковый — нейросеть пишет как ей вздумается, и часто капсом.</p><p>При этом правила я настраивал в том числе с использованием нейросети в самом cursor, и по мнению нейросети у меня отличные правила, которые точно должны работать, но похоже где-то есть ограничения или баги в самом cursor.</p><h3>Swift</h3><p>Нейросеть легко напишет код для структуры с @Published-полями внутри - такое я впервые увидел именно в cursor, хотя использовал эту же нейросеть в perplexity - там такой фигни не было 😁</p><p>Concurrency? Не слышал. В проекте лежит файл с версией Swift, в настройках проекта тоже явно указана строгая проверка на concurrency, но либо cursor всего этого не видит, либо нейросеть сильно тупит, потому что при работе со всякими Task внутри классов каждый раз возникают ошибки билда, которые потом нейросеть чинит в несколько итераций. В конечном итоге cursor может просто удалить этот код и сказать, что теперь все работает 🙈</p><p>Минимальную версию iOS в проекте тоже не уважает - легко пишет код с использованием import Observation в проекте с iOS 15.</p><p>Если это и должно решаться правилами, то правила работают плохо, и мне не хочется тратить время на битву с неработающим функционалом — просто в том же диалоге пишу “не используй Observation, потому что в проекте iOS 15”.</p><h4>UI/UX</h4><p>Мне не понравился ни UI, ни UX в cursor. Знаю, что это немного измененный Visual Studio Code, но тот мне тоже совсем не нравится — для iOS-разработки Xcode на мой взгляд лучший, во всяком случае пока. И знаю, что есть ребята, которым наоборот больше нравятся сторонние IDE, но я не в их числе 😁</p><p>Чтобы разобраться в настройках cursor, мне пришлось обращаться к нескольким нейросетям, включая встроенные в самом cursor, и ни одна мне не дала правильный ответ ни разу, потому что настройки там просто дикие: есть Cursor Settings, которые открываются при нажатии на шестеренку, а есть Settings, которые открываются при нажатии на open в разделе General -&gt; Editor Settings.</p><p>Если вам вдруг понадобится изменить настройки cursor напрямую в json, то это можно сделать именно в Editor Settings -&gt; Open Settings (JSON) - эта кнопочка отображается справа сверху, и ее легко не заметить.</p><p>Решили что-то написать в cursor в коде проекта, а потом понадобилось перейти в Xcode? А вот и нифига — пока вручную не сохранишь в cursor свои изменения, они не отобразятся в Xcode. Я два раза пытался что-то написать в cursor, но просто бросил эту затею — привыкать к новой IDE без повода не хочу и не буду.</p><h4>Дебаг</h4><p>У меня установлен sweetpad для дебага, и я честно попробовал им воспользоваться, даже дважды. Этот раздел можно было смело сложить в предыдущий про UI/UX, но там уже и без того немало написано.</p><p>Симулятор запускается дольше, чем в Xcode, логи отображаются без фильтров по уровню, ну и в принципе нет этого функционала, ведь это не Xcode. Если я его просто не нашел, то опять же не удивляюсь, потому что UI/UX там на мой взгляд просто никакой 🤬</p><p>Скорее всего при большом желании можно пересесть на cursor даже для дебага, но должна быть сильная мотивация, и желание должно быть очень большим (ну или должна быть сильная ненависть к Xcode).</p><h3>Разработчики резко теряют работу</h3><p>Нет.</p><p><strong>Это просто новый инструмент</strong>, который кому-то поможет разобраться в проекте, сделать фичу или поправить старый баг, а кому-то поможет наговнокодить с три короба, потому что нужно уметь формулировать постановку задачи, чтобы нейросеть сделала то что нужно (или хотя бы рядом с этим).</p><p>В интернете многие пишут, что не знают языка программирования, но с cursor написали целый проект с нуля и уже отправили в прод, и бла-бла-бла.<br>Одно дело — нагенерировать код и радоваться рабочему приложению/сайту/телеграм-боту, а другое дело — решать настоящие задачи в настоящих проектах, за зарплату. Можно и без нейросети научиться получать зарплату, почти не работая, но даже в этом случае на первом месте софт-скилы, а на втором — инструменты типа cursor и т.д.</p><p>Так что если вас посещает мысль <strong>“войти в айти”</strong> с использованием cursor или подобных инструментов <strong>без навыков программирования</strong>, то мне остается чистосердечно пожелать вам удачи 😉</p><p>Считаю свой гайд <a href="https://telegra.ph/Kak-stat-iOS-razrabotchikom-02-23">“Как стать iOS-разработчиком”</a> все еще актуальным и полезным для старта в iOS.</p><h3>Заключение</h3><p>Несмотря на все перечисленные минусы, мне очень понравилось делать задачи с использованием cursor, и я все время сравниваю этот процесс с предыдущим вариантом — использованием веб-версий разных нейросетей, включая perplexity, qwen, deepseek (RIP).</p><p>Возможность не открывать браузер для решения большинства вопросов по проекту — это невероятный плюс, который перевешивает все минусы.</p><p>Особенно круто cursor себя показывает при погружении в новый проект, и вполне может помочь с онбордингом в команде, чтобы не дергать по каждому вопросу коллег.</p><p>Я все еще очень жду релизную версию Xcode 26, чтобы сравнить нативный режим агента с вариантом от cursor, а бета-версию не ставлю, потому что мне хватает официальных <a href="https://developer.apple.com/documentation/xcode-release-notes/xcode-26-release-notes#Coding-Intelligence">релизных заметок</a>. И даже если целиком перейду на Xcode 26 осенью, то все равно продолжу использовать cursor для проектов на других языках программирования, пока не появится более удобная альтернатива 🙂</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6b7e2dc7a8d2" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[124. Адаптируем NavigationSplitView]]></title>
            <link>https://oleg991.medium.com/124-%D0%B0%D0%B4%D0%B0%D0%BF%D1%82%D0%B8%D1%80%D1%83%D0%B5%D0%BC-navigationsplitview-9f25ccc1454a?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/9f25ccc1454a</guid>
            <category><![CDATA[navigationsplitview]]></category>
            <category><![CDATA[swiftui]]></category>
            <category><![CDATA[navigation]]></category>
            <category><![CDATA[swift]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sat, 21 Jun 2025 15:20:11 GMT</pubDate>
            <atom:updated>2025-06-21T15:20:11.644Z</atom:updated>
            <content:encoded><![CDATA[<p>В iOS 16 добавили <a href="https://developer.apple.com/documentation/swiftui/navigationsplitview">NavigationSplitView</a>, чтобы можно было расположить контент в 2 или 3 колонки. В этой мини-статье расскажу основные моменты по адаптации этой штуки в приложении для iOS, чтобы ничего не сломалось.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/735/1*-Jdpo-CCcyJFY0VNyPPODQ@2x.png" /><figcaption>“Навигация” в официальной документации</figcaption></figure><h3>Вводные</h3><p>Возьмем iOS-приложение, в котором навигация построена на <a href="https://developer.apple.com/documentation/swiftui/navigationstack">NavigationStack</a>, т.е. можно ходить по экранам вперед/назад стандартными способами и с помощью <a href="https://developer.apple.com/documentation/swiftui/view/navigationdestination(for:destination:)">navigationDestination</a>. Кстати, подобное приложение я уже показывал в <a href="https://telegra.ph/43-Primer-raboty-s-NavigationStack-12-02">статье 43</a>.</p><p>Задача в том, чтобы сохранить внешний вид и поведение приложения на айфоне при переходе с NavigationStack на NavigationSplitView. в приложении со списками (необязательно <a href="https://developer.apple.com/documentation/swiftui/list">List</a>, просто любой вертикальный контент в скролле с кнопками для перехода на следующий экран).</p><p>Для краткости буду называть NavigationStack просто NS, а NavigationSplitView - NSV.</p><p>Важно помнить, что NSV по умолчанию будет показывать все свои столбцы не только на айпаде, но и в том числе на айфонах pro max и plus в ландшафтном режиме.</p><h3>Основные компоненты</h3><p>NSV предлагает нам до трех столбцов: sidebar, content, detail. Вот этот инициализатор для примера:</p><pre>init(<br>    @ViewBuilder sidebar: () -&gt; Sidebar,<br>    @ViewBuilder content: () -&gt; Content,<br>    @ViewBuilder detail: () -&gt; Detail<br>)</pre><p>Официальная документация в этом случае меня не порадовала, вот пример описания этих столбцов (на русском для удобства):</p><ul><li>sidebar - вьюха для отображения колонки слева</li><li>content - вьюха для отображения колонки по центру</li><li>detail - вьюха для отображения зоны с детализацией</li></ul><p>Дальше будет мое описание, полученное на личном опыте 😁</p><h4>Sidebar</h4><p>Именно эта вьюха отображается по умолчанию на айфоне при использовании NS - с нее можно перейти на следующий экран через push (navigationLink).</p><p>То есть при замене NS на NSV в нашем приложении именно в sidebar нужно поместить весь контент корневого экрана навигации, который мы хотим видеть на айфоне при отображении условного списка элементов.</p><p>Ширину этой вьюхи на айпаде можно настроить модификатором navigationSplitViewColumnWidth, у которого есть 2 версии: <a href="https://developer.apple.com/documentation/swiftui/view/navigationsplitviewcolumnwidth(_:)">первая</a> для конкретной ширины, <a href="https://developer.apple.com/documentation/swiftui/view/navigationsplitviewcolumnwidth(min:ideal:max:)">вторая</a> для нескольких вариантов.</p><h4>Content</h4><p>Эта вьюха вряд ли пригодится большинству приложений: она служит первым уровнем детального контента, который можно увидеть при нажатии на элемент списка в sidebar на айпаде, т.е. подойдет для какой-нибудь подкатегории, например.</p><p>На айфоне именно тут будут открываться экраны через navigationLink с главного списка, что будет выглядеть нормально (как всегда) в портретном режиме, а вот если приложение поддерживает ландшафтный режим, то все будет выглядеть совсем не как обычно, а прямо как на айпаде - в три столбца.</p><h4>Detail</h4><p>Если явно не указать content (из предыдущего раздела статьи) для NSV, то именно в detail будет отображаться экран, открытый через navigationLink (и на айфоне, и на айпаде) в любом режиме (портретный/ландшафтный).</p><h4>Другие инициализаторы</h4><p>У NSV есть несколько других инициализаторов, которые могут пригодиться в отдельных случаях - все их можно найти в <a href="https://developer.apple.com/documentation/swiftui/navigationsplitview">документации</a>.</p><p>Например, можно настроить columnVisibility, чтобы при повороте экрана (меняется horizontalSizeClass) изменять и видимость колонок:</p><pre>@Environment(\.horizontalSizeClass) var horizontalSizeClass<br>@State private var columnVisibility = NavigationSplitViewVisibility.automatic<br>// и потом где-нибудь в onChange(of: ...)<br>columnVisibility = horizontalSizeClass == .regular &amp;&amp; isEmpty<br>? .detailOnly<br>: .automatic</pre><h3>Заключение</h3><p>NavigationSplitView прикольный инструмент для быстрой адаптации приложения под айпад, но только если ваше приложение будет нормально выглядеть и работать с такой навигацией.</p><p>Настройки есть, но как и в случае с привычной навигацией для айфона — не особо разнообразные. Если ваше приложение поддерживает айпад, структура навигации напоминает то, что показывают в официальной документации, и вы поддерживаете iOS 16+ ... немало условий, да? 😁</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9f25ccc1454a" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[123. Публикуем сборку с fastlane]]></title>
            <link>https://oleg991.medium.com/123-%D0%BF%D1%83%D0%B1%D0%BB%D0%B8%D0%BA%D1%83%D0%B5%D0%BC-%D1%81%D0%B1%D0%BE%D1%80%D0%BA%D1%83-%D1%81-fastlane-92ad2aacbff1?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/92ad2aacbff1</guid>
            <category><![CDATA[app-store]]></category>
            <category><![CDATA[testflight]]></category>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[fastlane]]></category>
            <category><![CDATA[automation]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sat, 14 Jun 2025 07:01:32 GMT</pubDate>
            <atom:updated>2025-06-14T07:01:32.807Z</atom:updated>
            <content:encoded><![CDATA[<p>В <a href="https://oleg991.medium.com/4c22d3c4e301">статье 114</a> рассказывал про <a href="https://www.google.com/url?sa=t&amp;source=web&amp;rct=j&amp;opi=89978449&amp;url=https://developer.apple.com/xcode-cloud/&amp;ved=2ahUKEwj23K3Z6uGNAxWw48kDHYRgKMUQFnoECAoQAQ&amp;usg=AOvVaw00MiBPLH_dqLhcQ0liQ7JY">Xcode Cloud</a>, а в этой статье расскажу как настроить публикацию сборок iOS-приложений в TestFlight с помощью <a href="https://fastlane.tools/">fastlane</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lv8YSTezu6MoQw30Z9j4_g.jpeg" /></figure><h3>Прежде чем начать</h3><p>Для настройки fastlane я взял приложение <a href="https://github.com/easydev991/SwiftUI-Days">“Счётчик дней”</a>, где уже настроен Xcode Cloud : на каждое изменение в main-ветке запускается процесс сборки, и в случае успеха она попадает в TestFlight.</p><p>В этом проекте уже была выполнена базовая настройка fastlanе, чтобы пользоваться fastlane snapshot (памятка есть в <a href="https://oleg991.medium.com/e8f05cdaa894">статье 109</a>).</p><p>Базовая настройка выполняется несложно, весь процесс уже автоматизирован в <a href="https://github.com/easydev991/SwiftUI-Days/blob/main/Makefile">Makefile</a>, о котором рассказал в <a href="https://oleg991.medium.com/f284a4379f27">статье 122</a> (там есть специальная команда make setup_fastlane).</p><p>До настройки публикации сборок с использованием fastlane я не настраивал себе сертификат Apple Distribution и Provisioning profile — все это будет в данной статье.</p><p>Статья актуальна для Xcode 16.4.</p><h4>Варианты настройки fastlane</h4><p>Есть 2 основных варианта, из которых я выбирал:</p><ol><li>Настроить все с использованием AppFile/Matchfile</li><li>Настроить все с использованием .env-файла (без AppFile/Matchfile)</li></ol><p>Я выбрал второй вариант, потому что он показался мне намного проще для старта, и т.к. над пет-проектом я работаю один, то мне нет смысла заморачиваться с дополнительными сложностями для хранения секретов в особом репозитории или на CI/CD (ведь у меня нет CI/CD). Под секретами понимаем чувствительные данные типа логинов/паролей/сертификатов.</p><h4>Про сложные моменты</h4><p>Настроить fastlane сложнее, чем Xcode Cloud, потому что инструмент древний, актуальную инструкцию под нужную версию Xcode найти сложно/невозможно, но это нормально — со всеми сложностями нам помогают интернеты (нейросети). Бояться не нужно, все решаемо.</p><h3>План</h3><ol><li>Создать distribution-сертификат — используем приложение Keychain Access и портал Apple Developer</li><li>Создать Provisioning profile — используем портал Apple Developer</li><li>Добавим новый lane в Fastfile с указанием provisioningProfiles и apple_id</li><li>Создадим и настроим .env-файл для хранения секретов</li><li>Загрузим сборку в TestFlight с помощью fastlane</li><li>Добавим в gitignore: fastlane/.env, *.ipa, *.dSYM.zip, *.dSYM</li></ol><h3>Apple Distribution</h3><p>Открываем приложение Keychain Access (связка ключей).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WXFlBukRRKlfiNnKyMhw9w.png" /><figcaption>Ассистент сертификации -&gt; Запросить сертификат у бюро сертификации</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ah8VVpxJfoZjFETSq-T-bg.png" /><figcaption>Заполняем ваш email, имя и ставим галку “Сохранен на диске”, жмем “Продолжить”</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7NJlumSRcbieXso--Y7xbA.png" /><figcaption>Сохраняем файл в любое место в finder, потом будем его использовать</figcaption></figure><p>Открываем <a href="https://developer.apple.com/account/resources/certificates/list">сайт Apple Developer</a> на странице с сертификатами, далее:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mLceDbmdXzZtj0bjvTW06w.png" /><figcaption>Жмем на плюс</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lb4DzKaUuQmNcc-rCojhDg.png" /><figcaption>Выбираем “Apple Distribution” и жмем “Continue”</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_dkOkpIcOEq7QaO102AVgg.png" /><figcaption>Жмем “Choose File”, выбираем там ранее созданный файл, жмем “Continue”</figcaption></figure><p>На следующем экране будет отображаться готовый сертификат и кнопка для загрузки справа сверху, далее:</p><ul><li>жмем “загрузить”</li><li>открываем его двойным кликом</li><li>проверяем его наличие в “Связке ключей” на вкладке “Сертификаты”</li></ul><h3>Provisioning profile</h3><p>Открываем <a href="https://developer.apple.com/account/resources/profiles/list">сайт Apple Developer</a> на странице с профилями, далее:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lBZHatsZnz60FdryZwjbtw.png" /><figcaption>Жмем на плюс</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h4dPjf25A37ZokT0DbL8JQ.png" /><figcaption>В разделе “Distribution” выбираем “App Store Connect”, жмем “Continue”</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*M7n0DHxRNjscEBDDcooV8g.png" /><figcaption>Выбираем идентификатор нужного приложения в поле “App ID”, жмем “Continue”</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TOnc4v8S8Tjqap3kfD7xdg.png" /><figcaption>Ставим галку на своем “distribution”-сертификате и жмем “Continue”</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WvEX1WjJBd9e2fArTMwdNg.png" /><figcaption>Вводим название профиля и жмем “Generate” — это название нам пригодится на следующем шаге</figcaption></figure><p>На следующем экране будет кнопка для загрузки профиля — жмем и загружаем файл профиля, после этого открываем как и сертификат — двойным кликом.</p><p>Проверяем, что файл профиля появился в папке ~/Library/Developer/Xcode/UserData/Provisioning Profiles/:</p><pre>open ~/Library/Developer/Xcode/UserData/Provisioning\ Profiles/</pre><p>В открывшейся папке должен быть профиль, который был установлен недавно двойным кликом.</p><h3>Новый lane — release</h3><p>Как выглядел fastfile раньше — был один lane для генерации скриншотов, созданный автоматически при первоначальной настройке fastlane :</p><pre>default_platform(:ios)<br><br>platform :ios do<br>  desc &quot;Generate new localized screenshots&quot;<br>  lane :screenshots do<br>    capture_screenshots(scheme: &quot;SwiftUI-DaysUITests&quot;)<br>  end<br>end</pre><p>Теперь добавим новый lane для отправки сборки в TestFlight:</p><pre>default_platform(:ios)<br><br>platform :ios do<br>  desc &quot;Generate new localized screenshots&quot;<br>  lane :screenshots do<br>    capture_screenshots(scheme: &quot;SwiftUI-DaysUITests&quot;)<br>  end<br><br>  desc &quot;Собрать и отправить сборку в TestFlight&quot;<br>  lane :release do<br>    build_app(<br>      scheme: &quot;SwiftUI-Days&quot;,<br>      export_method: &quot;app-store&quot;,<br>      export_options: {<br>        provisioningProfiles: {<br>          &quot;com.oleg991.SwiftUI-Days&quot; =&gt; &quot;SwiftUI-Days App Store (fastlane)&quot;<br>        }<br>      }<br>    )<br>    upload_to_testflight(<br>      skip_waiting_for_build_processing: true,<br>      apple_id: &quot;6744068216&quot;<br>    )<br>  end<br>end</pre><p>Если явным образом не указать provisioningProfiles и apple_id, то у меня сборка не отправляется (судя по интернету, такое поведение является обычным для многих):</p><ul><li>данные для provisioningProfiles берем из bundle identifier и названия профиля с предыдущего шага</li><li>номер apple_id — это числовой Apple ID приложения из App Store Connect</li><li>skip_waiting_for_build_processing я поставил true, чтобы не ждать обработку сборки, но если поставить false, то при успешной отправке сборки fastlane продолжит выводить в терминале сообщение про ожидание обработки сборки</li></ul><h3>Храним секреты в .env-файле</h3><h4>Создаем app-specific password</h4><p>Инструкция есть на <a href="https://support.apple.com/en-us/102654">официальном сайте</a>, но на всякий случай расскажу в деталях.</p><p>Открываем <a href="https://account.apple.com/account/manage">страницу с настройками безопасности</a>, переходим в раздел “Пароли приложений” и жмем плюс для создания нового пароля:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*n70KpdWL3Fr7xVcXpYFsGQ.png" /><figcaption>Вводим название пароля приложения — оно нужно только для вас, нигде его указывать не придется</figcaption></figure><p>После успешного создания пароля он отобразится на экране — это будет единственная возможность скопировать его, нужно так и сделать.</p><h4>Создаем и наполняем .env-файл</h4><p>Переходим в терминале в папку fastlane внутри папки с проектом и создаем новый пустой .env-файл:</p><pre>cd путь/к/твоему/проекту/fastlane<br>touch .env</pre><p>Далее открываем файл любым удобным способом и заполняем:</p><pre>FASTLANE_USER=твой_apple_id@email.com<br>FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=твой_app_specific_password<br>FASTLANE_TEAM_ID=твой_team_id_из_Apple_Developer</pre><p><strong>Важно</strong>: в этом файле нигде не используются кавычки.</p><p><strong>Еще важнее</strong>: не делаем коммит с этотим файлом, не отправляем его в гит!</p><h3>Загружаем сборку с помощью fastlane</h3><p>Чтобы запустить процесс публикации, достаточно выполнить команду:</p><pre>bundle exec fastlane release</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/740/1*Hzv0KY2oqg83qYp8UlUjIQ.png" /><figcaption>Окончание загрузки сборки в терминале</figcaption></figure><p>Вот и все — сборка успешно отправлена, меньше чем за минуту. Потом она обработается и появится в разделе Testflight в App Store Connect.</p><h3>Обновляем gitignore</h3><p>Добавляем несколько строк в файл gitignore:</p><pre>fastlane/.env<br>*.ipa<br>*.dSYM.zip<br>*.dSYM</pre><ul><li>первая строка — это наш файл для хранения секретов, который нельзя публиковать по причине безопасности</li><li>остальные строки — это артефакты сборки, т.е. результаты работы fastlane, которые тоже не нужно без повода пушить в гит)</li></ul><h3>Заключение</h3><p>В этой статье я показал именно настройку fastlane для отправки сборок в TestFlight, и по этому процессу на мой взгляд fastlane проигрывает.</p><p>Для пет-проектов Xcode Cloud — это просто невероятное чудо, которое легко настроить и не нужно поддерживать, во всяком случае на моем опыте оно работает идеально.</p><p>Другое дело, что fastlane позволяет полностью автоматизировать публикацию сборки вместе со скриншотами, и в этом он побеждает (пока).</p><p>В больших компаниях на данный момент вряд ли захотят возиться с Xcode Cloud, если уже настроен fastlane, и скорее всего там будут использовать Appfile/Matchfile вместо .env-файла.</p><p>Другие статьи можно почитать <a href="http://t.me/easy_dev991">тут</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=92ad2aacbff1" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[122. Автоматизируем рутину в iOS-проекте]]></title>
            <link>https://oleg991.medium.com/122-%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B8%D1%80%D1%83%D0%B5%D0%BC-%D1%80%D1%83%D1%82%D0%B8%D0%BD%D1%83-%D0%B2-ios-%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B5-f284a4379f27?source=rss-7147e70f9e26------2</link>
            <guid isPermaLink="false">https://medium.com/p/f284a4379f27</guid>
            <category><![CDATA[swiftformat]]></category>
            <category><![CDATA[fastlane]]></category>
            <category><![CDATA[makefile]]></category>
            <category><![CDATA[automation]]></category>
            <category><![CDATA[ios]]></category>
            <dc:creator><![CDATA[Oleg991]]></dc:creator>
            <pubDate>Sat, 07 Jun 2025 07:02:17 GMT</pubDate>
            <atom:updated>2025-06-07T07:02:17.715Z</atom:updated>
            <content:encoded><![CDATA[<p>В <a href="https://telegra.ph/55-Nastraivaem-avto-formatirovanie-koda-02-23">статье 55</a> рассказывал как настроить автоматическое форматирование кода, а в <a href="https://telegra.ph/109-Pamyatka-po-fastlane-snapshot-02-23">статье 109</a> была памятка по генерации скриншотов. Тут расскажу как автоматизировать установку этих штук (и не только) с использованием Makefile.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*d-wQzk96ftgQ6PA_f8QA0w.png" /><figcaption>Нейросеть пишет код</figcaption></figure><h3>Предыстория</h3><p>Мне нравятся swiftformat и fastlane, и в целом их несложно установить и настроить, но делать это с нуля в новом проекте или на новом ноутбуке мне не очень нравится - этот процесс тратит время и нервы, т.к. что-то забывается, и потом что-то не работает.</p><p>И вот я решил запустить генерацию скриншотов для пет-проекта, но у меня не установлен fastlane, потому что использую другой ноутбук, и мне было очень лень снова разбираться как это сделать, поэтому я решил автоматизировать этот процесс на будущее.</p><p><strong>Важно</strong>: в проекте уже был настроен fastlane, и осталось настроить его на ноуте.</p><h3>Makefile</h3><p>Makefile — это текстовый файл, который содержит набор команд для автоматизации рутинных задач, а самое классное, что эти команды работают в macOS по умолчанию 🤯</p><h4>Почему Makefile — это удобно</h4><ul><li><strong>Всё в одном месте</strong>: не нужно держать в голове или искать в README список команд для установки Homebrew, Ruby, Bundler, fastlane, swiftformat и т.д.</li><li><strong>Минимум ручных действий</strong>: один раз написал Makefile — и дальше просто запускаешь нужную команду (make setup, make format, make fastlane), а скрипт сам проверит, что уже установлено, и что нужно доустановить.</li><li><strong>Легко поддерживать</strong>: если что-то поменялось (например, обновилась версия Ruby), достаточно поменять одну строчку в Makefile, и все новые установки будут с правильной версией.</li><li><strong>Удобно делиться с командой</strong>: любой, кто клонирует проект, сразу получает готовый сценарий для настройки окружения.</li><li><strong>Не нужно делать самостоятельно</strong>: просто обратись в нейросеть и попроси сделать/доработать Makefile с командами, которые тебе нужны в проекте.</li></ul><h3>Подробно на примере</h3><p>Разберём основные команды <a href="https://github.com/easydev991/SwiftUI-Days/blob/main/Makefile">на примере приложения «Счётчик дней»</a>.</p><h4>help</h4><p>Показывает справку по доступным командам. Просто набираешь make help, и видишь список всех возможностей скрипта:</p><pre>Доступные команды Makefile: <br><br>  help                 Показать это справочное сообщение<br>  setup                Проверить и установить все необходимые инструменты и зависимости для проекта (Homebrew, rbenv, Ruby, Bundler, fastlane, swiftformat)<br>  setup_hook           Установить pre-push git-хук для проверки форматирования Swift-кода<br>  setup_snapshot       Проверить инициализацию fastlane/fastlane snapshot, при необходимости предложить варианты установки<br>  setup_fastlane       Инициализировать fastlane в проекте (пошаговый процесс)<br>  update               Обновить fastlane и swiftformat (вызывает update_bundle и update_swiftformat)<br>  update_fastlane      Обновить только fastlane и его зависимости<br>  update_swiftformat   Обновить только swiftformat через Homebrew<br>  format               Запустить автоматическое форматирование Swift-кода с помощью swiftformat<br>  screenshots          Запустить fastlane snapshot для генерации скриншотов приложения<br><br>Рекомендуется сначала выполнить команду &#39;make setup&#39;</pre><h4>setup</h4><p>Главная команда для установки всех инструментов. Она:</p><ul><li>проверяет, установлен ли <a href="https://brew.sh/">Homebrew</a> (если нет — устанавливает)</li><li>проверяет, есть ли rbenv (менеджер версий Ruby) и нужная версия Ruby (3.2.2) - если чего-то не хватает, установит</li><li>создаёт или обновляет файл .ruby-version, чтобы все в проекте использовали одну и ту же версию Ruby</li><li>проверяет наличие Bundler нужной версии (это менеджер Ruby-зависимостей) и устанавливает, если нужно</li><li>устанавливает Ruby-гемы из Gemfile (в том числе fastlane)</li><li>проверяет, установлен ли swiftformat (утилита для форматирования кода) - если нет — устанавливает</li><li>проверяет, установлен ли fastlane - если да, то проверяет установку fastlane snapshot (для генерации скриншотов) и устанавливает, если в проекте еще нет файла Snapfile (там настройки для fastlane snapshot); а если fastlane не установлен - предлагает либо установить с нуля fastlane snapshot, либо ничего не делать (можно установить все вручную)</li></ul><p>Всё это с подсказками на русском языке и выделяется желтым, зеленым или красным цветом — понятно, где что происходит и что делать дальше.</p><h4>format</h4><p>Запускает автоматическое форматирование кода через swiftformat. Если вдруг swiftformat не установлен, команда сама вызовет make setup и доустановит всё необходимое.</p><h4>screenshots</h4><p>Запускает fastlane snapshot для генерации скриншотов приложения. Если fastlane не найден, вызывается make setup_snapshot, чтобы всё нужное появилось.</p><h4>update</h4><p>Проверяет наличие обновлений для fastlane и swiftformat и обновляет при необходимости до последних версий. Если обновился fastlane, то обновляет файл Gemfile.lock. После этого достаточно закоммитить обновлённый файл — и все в команде будут использовать одни и те же версии зависимостей.</p><h3>Примеры использования</h3><ol><li>Только что клонировал проект или пересел за новый ноутбук? Просто выполняешь в терминале make setup — и через несколько минут всё готово к работе</li><li>Нужно отформатировать код перед коммитом? make format</li><li>Пришло время обновить fastlane или другие Ruby-гемы? make update</li><li>Нужно сгенерировать скриншоты приложения? make screenshots</li></ol><h3>Уточнение про скриншоты</h3><p>Для генерации скриншотов недостаточно просто установить fastlane snapshot, и выполнить команду make screenshots.</p><p>Сначала нужно написать ui-тесты, и об этом я рассказывал в <a href="https://oleg991.medium.com/cb1acc7cde8a">статье 77</a>.</p><h3>Заключение</h3><p>Makefile — это как твой личный помощник по настройке проекта. Он экономит время, снижает вероятность ошибок и делает процесс установки зависимостей максимально прозрачным и простым, даже если ты только начинаешь путь в iOS-разработке.</p><p>С появлением нейросетей такие штуки несложно изучить и реализовать 😎</p><p>Код для этой статьи можно посмотреть <a href="https://github.com/easydev991/SwiftUI-Days/blob/main/Makefile">тут</a>, а другие статьи — <a href="http://t.me/easy_dev991">тут</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f284a4379f27" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>