Установка и обновления

DevMachine ADE — одно приложение: внутри уже есть агент и всё, что ему нужно для работы на компьютере. Отдельно ничего ставить не придётся. Одно исключение — git, программа, которая хранит историю изменений файлов проекта. В приложение он не встроен, поэтому клонировать репозитории (папки проектов под git) и работать в Git-клиенте можно, только если git установлен в системе. На macOS и Windows приложение обновляется само, на Linux — командой или новым архивом.

#Системные требования

Все сборки — на странице загрузки. Страница сама определяет систему, а если открыть её с телефона, предложит отправить ссылку на компьютер. Ссылки на все сборки есть и в веб-кабинете, на странице «Обзор».

#Установка на macOS

1. Скачайте .dmg для своего процессора.
2. Откройте его из «Загрузок» и перетащите DevMachine ADE в «Программы».
3. Запустите DevMachine ADE из «Программ» и войдите в аккаунт.

#Установка на Windows

1. Скачайте установщик .exe.
2. Запустите его. Права администратора не нужны: приложение ставится только для вашей учётной записи.
3. Если Windows покажет «Система Windows защитила ваш компьютер», нажмите «Подробнее» → «Выполнить в любом случае». Фильтр SmartScreen показывает это предупреждение, потому что установщик пока не подписан сертификатом для Windows.
4. Откройте DevMachine ADE с рабочего стола или из меню «Пуск» и войдите в аккаунт.

Установщик создаёт ярлыки на рабочем столе и в «Пуске» и добавляет запись в «Установка и удаление программ».

#Установка на Linux

Из архива. Подходит, если хотите держать приложение в своей папке.

1. Скачайте архив для своей архитектуры: x64 или arm64.

2. Распакуйте его:

   tar xzf DevMachine-Linux-x64.tar.gz
   

3. В распакованной папке koder-ade-linux-x64 (или koder-ade-linux-arm64) запустите ./koder-ade.

Для всех пользователей компьютера. Одна команда скачает приложение, проверит файл и установит его в /opt/koder-ade, а ещё добавит пункт в меню приложений и команду koder-ade. Нужны права администратора, их даёт sudo в команде. Откройте терминал — окно, где программы запускают текстовыми командами, — и выполните:

curl -fsSL https://devmachine.ai/downloads/install-ade.sh | sudo bash

Чтобы обновить приложение, запустите ту же команду ещё раз.

#Вход

При первом запуске нажмите «Войти через браузер». На macOS и Windows откроется devmachine.ai, а после входа браузер вернёт вас в приложение. На Linux приложение покажет ссылку и код: откройте ссылку в браузере на любом компьютере и подтвердите вход. Подробнее — в разделе «Аккаунт и веб-кабинет».

#Обновления

#Как приложение узнаёт о новой версии

Новые версии приложение берёт из канала загрузок — с адреса devmachine.ai/downloads, откуда скачиваются и сборки со страницы загрузки. Канал оно проверяет вскоре после запуска, потом раз в несколько часов и ещё когда вы возвращаетесь в его окно. С компьютера при этом уходит только запрос списка версий.

О новой версии вы узнаете в трёх местах:

• строка «Доступно обновление» внизу левой колонки;
• запись «Доступна версия …» в журнале уведомлений под колокольчиком «Уведомления» в шапке;
• «Настройки → О приложении»: «Доступна версия …» и кнопка «Обновить до …». Если обновлять нечего, там написано «Установлена последняя версия».

#macOS и Windows

1. Нажмите «Доступно обновление» внизу слева или «Обновить до …» в настройках.
2. Дождитесь, пока обновление скачается. Приложение сверит файл с контрольной суммой из канала загрузок: так оно убедится, что файл скачался целиком и не изменён. Ничего делать для этого не нужно.
3. Когда появится «… готова», нажмите «Перезапустить». Приложение откроется уже в новой версии, чаты сохранятся.

Если приложение запущено прямо из образа или у него нет прав на запись в свою папку, файл скачается в «Загрузки» и откроется. Тогда на macOS перетащите приложение в «Программы» и перезапустите его, а на Windows запустите скачанный установщик: он закроет приложение и поставит новую версию.

#Linux

На Linux приложение само не обновляется.

• Если ставили командой для всех пользователей. Нажмите строку о новой версии внизу слева или «Скопировать команду обновления до …» в «Настройки → О приложении», и приложение скопирует команду установки из раздела «Установка на Linux» — ту же, которой его ставили. Выполните её в терминале с правами администратора (sudo) и перезапустите приложение.
• Если запускаете из распакованного архива. Скачайте новый архив со страницы загрузки и распакуйте его на место прежней папки. Или перейдите на установку для всех пользователей: выполните скопированную команду и дальше запускайте приложение из меню или командой koder-ade.

Чаты, вход и настройки лежат в домашней папке, отдельно от папки приложения, поэтому обновление их не трогает.

#Что нового

После обновления в журнале уведомлений появляется запись «Обновлено до …» со списком изменений в разделах «Новое» и «Исправлено». История изменений всех версий до вашей — в «Настройки → О приложении → Что нового». Иногда описание новой версии появляется чуть позже самой сборки.

#Удаление

• macOS. Закройте приложение и перетащите DevMachine ADE из «Программ» в Корзину.
• Windows. Найдите DevMachine ADE в «Установка и удаление программ» и удалите. Вход и чаты при этом останутся на компьютере.
• Linux. Удалите папку, в которую распаковали архив.

#Ограничения

• Сборки для Windows на процессорах ARM нет.
• Чтобы клонировать репозитории и работать в Git-клиенте, в системе должен быть установлен git.
• На Linux вход — только по коду, а обновление — командой с правами администратора или новым архивом.

#Что дальше

• Быстрый старт — первая задача агенту.
• Проекты — как открыть папку, склонировать репозиторий или начать без проекта.
• Если что-то не работает — ошибки обновления, входа и запуска.