Перейти к содержимому
Wails Blog

Ваше первое приложение

Это руководство показывает, как создать ваше первое приложение на Wails v3, охватывая настройку проекта, сборку и рабочий процесс разработки.



  1. Создание нового проекта

    Заголовок раздела «Создание нового проекта»

    Откройте терминал и выполните следующую команду для создания нового проекта Wails:

    Окно терминала
    wails3 init -n myfirstapp

    Эта команда создаст новую директорию с именем myfirstapp со всеми необходимыми файлами.

  2. Изучение структуры проекта

    Заголовок раздела «Изучение структуры проекта»

    Перейдите в директорию myfirstapp. Вы найдете несколько файлов и папок:

    • Директорияbuild/ Содержит файлы, используемые процессом сборки
      • appicon.png Иконка приложения
      • config.yml Конфигурация сборки
      • Taskfile.yml Задачи сборки
      • Директорияdarwin/ Файлы сборки, специфичные для macOS
        • Info.dev.plist Конфигурация для разработки
        • Info.plist Конфигурация для продакшена
        • Taskfile.yml Задачи сборки для macOS
        • icons.icns Иконка приложения для macOS
      • Директорияlinux/ Файлы сборки, специфичные для Linux
        • Taskfile.yml Задачи сборки для Linux
        • Директорияappimage/ Упаковка AppImage
          • build.sh Скрипт сборки AppImage
        • Директорияnfpm/ Упаковка NFPM
          • nfpm.yaml Конфигурация пакета
          • Директорияscripts/ Скрипты сборки
            • …
      • Директорияwindows/ Файлы сборки, специфичные для Windows
        • Taskfile.yml Задачи сборки для Windows
        • icon.ico Иконка приложения для Windows
        • info.json Метаданные приложения
        • wails.exe.manifest Файл манифеста Windows
        • Директорияnsis/ Файлы установщика NSIS
          • project.nsi Файл проекта NSIS
          • wails_tools.nsh Вспомогательные скрипты NSIS
    • Директорияfrontend/ Файлы фронтенд-приложения
      • index.html Основной HTML-файл
      • main.js Основной JavaScript-файл
      • package.json Конфигурация пакета NPM
      • Директорияpublic/ Статические ресурсы
        • …
      • Inter Font License.txt Лицензия на шрифт
    • .gitignore Файл игнорирования Git
    • README.md Документация проекта
    • Taskfile.yml Задачи проекта
    • go.mod Файл модуля Go
    • go.sum Контрольные суммы модуля Go
    • greetservice.go Сервис приветствия
    • main.go Основной код приложения

    Уделите немного времени изучению этих файлов и ознакомьтесь со структурой.

  3. Сборка вашего приложения

    Заголовок раздела «Сборка вашего приложения»

    Чтобы собрать ваше приложение, выполните:

    Окно терминала
    wails3 build

    Эта команда компилирует отладочную версию вашего приложения и сохраняет её в новой директории bin.

    После сборки вы можете запустить её так же, как любое обычное приложение:

    Окно терминала
    ./bin/myfirstapp

    Вы увидите простой интерфейс, который является отправной точкой для вашего приложения. Поскольку это отладочная версия, вы также увидите логи в окне консоли. Это полезно для целей отладки.

  4. Режим разработки

    Заголовок раздела «Режим разработки»

    Мы также можем запустить приложение в режиме разработки. Этот режим позволяет вносить изменения в код фронтенда и видеть эти изменения в работающем приложении без необходимости пересобирать всё приложение заново.

    1. Откройте новое окно терминала.
    2. Запустите wails3 dev. Приложение скомпилируется и запустится в режиме отладки.
    3. Откройте frontend/index.html в вашем любимом редакторе.
    4. Измените код и замените Please enter your name below на Please enter your name below!!!.
    5. Сохраните файл.

    Это изменение отобразится в вашем приложении немедленно.

    Любые изменения в коде бэкенда вызовут пересборку:

    1. Откройте greetservice.go.
    2. Измените строку return "Hello " + name + "!" на return "Hello there " + name + "!”`.
    3. Сохраните файл.

    Приложение обновится в течение нескольких секунд.

  5. Упаковка вашего приложения

    Заголовок раздела «Упаковка вашего приложения»

    Когда ваше приложение готово к распространению, вы можете создать пакеты, специфичные для платформы:

    Чтобы создать бандл .app:

    Окно терминала
    wails3 package

    Это создаст сборку для продакшена и упакует её в бандл .app в директории bin.

    Для получения более подробной информации о вариантах упаковки и конфигурации, ознакомьтесь с нашим Руководством по упаковке.

  6. Настройка системы контроля версий и имени модуля

    Заголовок раздела «Настройка системы контроля версий и имени модуля»

    Ваш проект создается с именем модуля-заполнителя changeme. Рекомендуется обновить его, чтобы оно соответствовало URL вашего репозитория:

    1. Создайте новый репозиторий на GitHub (или на предпочитаемой вами платформе Git)
    2. Инициализируйте git в директории вашего проекта:
      Окно терминала
      git init
      git add .
      git commit -m "Initial commit"
    3. Укажите удаленный репозиторий (замените на URL вашего репозитория):
      Окно терминала
      git remote add origin https://github.com/username/myfirstapp.git
    4. Обновите имя модуля в go.mod, чтобы оно соответствовало URL вашего репозитория:
      Окно терминала
      go mod edit -module github.com/username/myfirstapp
    5. Отправьте ваш код:
      Окно терминала
      git push -u origin main

    Это гарантирует, что имя вашего Go-модуля соответствует соглашениям об именовании модулей Go и облегчает обмен вашим кодом.

Поздравляем!

Заголовок раздела «Поздравляем!»

Вы только что создали, разработали и упаковали своё первое приложение на Wails. Это лишь начало того, чего вы можете достичь с помощью Wails v3.

Следующие шаги

Заголовок раздела «Следующие шаги»

Если вы новичок в Wails, мы рекомендуем прочитать наши Уроки, которые станут практическим руководством по различным функциям Wails. Первый урок — Создание сервиса.

Если вы более продвинутый пользователь, ознакомьтесь с нашими Руководствами для получения более подробной информации о том, как использовать Wails.