For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/desktop/ship-in-5-minutes.md (or send Accept: text/markdown).
Запустите настольное приложение за 5 минут
Подготовьте Rust и инструменты сборки вашей операционной системы, запустите доступный веб-сервер, запустите окно Tauri и проверьте поведение лотка, ярлыка и локальных задач.
1. Установите общие и родные инструменты
Завершение. Прежде чем начать, клонируйте репозиторий Desktop или монорепозиторий для всех платформ и откройте его в редакторе. Рабочий стол — это собственное окно того же веб-приложения. Он не включает вторую реализацию учетных записей или чата. Пятиминутный запуск начинается после установки зависимостей и собственных инструментов; Первая установка и компиляция Rust часто занимают больше времени.
В Windows установите Microsoft C++ Build Tools, используя ссылку на необходимые условия Tauri ниже. В установщике выберите «Разработка рабочего стола с помощью C++», оставьте выбранным Windows SDK и завершите установку. Убедитесь, что установлена среда выполнения Microsoft Edge WebView2. Установите Rust из Rustup.rs с помощью Rustup-init.exe; сохраните набор инструментов MSVC по умолчанию. Снова откройте терминал после установки.
В macOS запустите xcode-select --install в Терминале и заполните диалоговое окно инструментов командной строки, если они не установлены. Установите Rust с помощью команды macOS из Rustup.rs. В Linux перейдите на страницу предварительных требований Tauri для получения пакетов WebKitGTK, компилятора, лотка и системной библиотеки вашего конкретного дистрибутива, а затем установите Rust. Названия пакетов Linux различаются; не запускайте команды другого дистрибутива.
Откройте терминал в корне репозитория и запустите проверку версий ниже. И rustc, и cargo должны печатать версии; cargo — инструмент сборки Rust. Если что-то отсутствует, завершите установку и снова откройте терминал, прежде чем продолжить.
- Установите инструменты и получите код
- Узнайте, как запустить команду и отредактировать файл
- Контрольный список требований к операционной системе Tauri
- Официальный установщик Rust
rustc --version
cargo --version
corepack pnpm install2. Запустите или выберите веб-сервер.
Если ваша проверка содержит apps/web, следуйте веб-руководству, создайте apps/web/.env.local, запустите веб-сервер в отдельном терминале, используя команду ниже, и оставьте его включенным. Сначала проверьте http://localhost:3000 в своем браузере. Вы можете использовать демонстрацию /dashboard без базы данных; Для реального входа в систему /auth необходимо перенести Postgres.
Оформление заказа только для настольного компьютера не содержит apps/web.. Используйте отдельно работающий веб-сервер, поставляемый для вашего продукта, и откройте его URL в браузере, чтобы убедиться, что он работает. Оболочка рабочего стола не может создать за вас серверную часть. Не используйте приведенную ниже веб-команду, если эта папка отсутствует. Шаг 3 показывает, как выбрать предоставленный внутренний адрес.
# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev3. Запустите окно рабочего стола.
Откройте второй терминал в корне репозитория, пока серверная часть продолжает работать. Для локального бэкэнда по умолчанию в http://localhost:3000, выполните первую команду ниже. Cargo может загружать библиотеки и компилировать оболочку; дождитесь открытия окна Supastack. Ожидаются сообщения компилятора во время первой сборки.
Для предоставленного бэкэнда замените https://app.example.com в соответствующем блоке операционной системы ниже на его фактический URL. Запускайте только блок вашей платформы. SUPASTACK_APP_URL — это параметр среды терминала, считываемый при запуске собственного процесса. Помещение его только в корневой .env не приведет к настройке оболочки. Следите за тем, чтобы серверная часть URL не содержала встроенных имен пользователей и паролей.
В монорепозитории для всех платформ corepack pnpm dev:desktop может запускать Web и Tauri вместе, как только pnpm находится на PATH, как описано в разделе «Перед началом работы». Приведенная ниже отфильтрованная команда также работает при оформлении заказов только на рабочем столе, при этом серверная часть работает отдельно.
# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev
# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev
# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev4. Проверьте окно, трей и ярлык
Успех означает, что в окне отображается та же домашняя страница, что и на вашем сервере в браузере. Окно рабочего стола не имеет адресной строки браузера. Чтобы открыть демонстрацию без учетных данных, выйдите из оболочки, используя действие «Выход» на панели задач, затем запустите приведенный ниже блок вашей операционной системы в настольном терминале, пока веб-сервер продолжает работать. Это загружает /dashboard напрямую; следуйте шагам локальной задачи веб-учебника. Для входа в реальную учетную запись используется серверная база данных, как и в браузере.
Закройте окно с помощью кнопки закрытия: приложение должно спрятаться в трее, а не выйти. Щелкните значок Supastack на панели задач или нажмите Ctrl + Shift + Пробел в Windows/Linux или Command + Shift + Пробел в macOS, чтобы отобразить его снова. Для выхода используйте действие «Выход» в трее. Чтобы полностью завершить разработку, также нажмите Ctrl + C в терминале рабочего стола, а затем остановите внутренний терминал.
Если окно пустое или показывает проблему с подключением, сначала откройте настроенный URL в браузере. Запустите серверную часть или исправьте URL, затем перезапустите Tauri. Если Rust сообщает, что linker.exe не найден, установите рабочую нагрузку Windows C++ и снова откройте терминал. Если Linux сообщает об отсутствии системной библиотеки, следуйте предварительным требованиям для конкретного дистрибутива. Если горячая клавиша уже занята, используйте панель задач и следуйте встроенному поведению, чтобы изменить ее.
Это запускает окно локальной разработки; он не создает подписанный установщик и не публикует приложение. Следите за распространением Desktop для сборок установщика, подписания платформы и тестирования на другом компьютере. Компиляция Windows не проверяет поведение macOS или Linux.
# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev
# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop devИспользуйте локальный URL приложения
Если переопределение не задано, Tauri загружает http://localhost:3000. Задавайте SUPASTACK_APP_URL, только если локальное приложение Next.js использует другой доступный источник HTTP(S). URL с учётными данными или без веб-протокола отклоняются.
Идентификатор bundle для разработки и конфигурация выпуска ещё не готовы для production. Проверка перед выпуском и подпись для каждой платформы описаны в отдельной инструкции по выпуску.