Первые шаги с Lino

Предварительные требования

Перед установкой Lino убедитесь, что ваше окружение подготовлено должным образом:

• ✅ .NET 9.0 SDK или более новая версия установлена. Скачать .NET
• ✅ CLI .NET доступна в терминале. Проверьте с помощью: dotnet --version
• ✅ Git установлен для контроля версий. Скачать Git
• ✅ Установлен Entity Framework Core CLI для поддержки миграций: dotnet tool install --global dotnet-ef
• ✅ Окружение контейнера совместимо с OCI, например, Docker Desktop или Podman.

Совместимость платформ

Lino является кроссплатформенным и может быть использован на основных операционных системах:

• ✅ Windows
• ✅ macOS
• ✅ Linux

Установка

Lino распространяется как глобальный инструмент для .NET. Перед продолжением убедитесь, что установлен SDK .NET 9 или выше.

Чтобы установить последнюю версию, выполните:

dotnet tool install --global Tolitech.Lino --version 1.0.0-alpha.10

После установки проверьте работу Lino, выполнив:

lino --version

Если установка прошла успешно, установленная версия будет отображена в терминале.

Аутентификация

После установки Lino необходимо пройти аутентификацию для доступа ко всем функциям.

Если у вас уже есть аккаунт, выполните вход с помощью команды:

lino auth login

Вам будет предложено ввести:

• Имя пользователя: Предварительно зарегистрированный адрес электронной почты.
• Пароль: Пароль, связанный с аккаунтом.

Если у вас нет аккаунта, зарегистрируйтесь напрямую через CLI, используя:

lino user register

При регистрации укажите:

• Имя: Имя пользователя.
• Фамилия: Фамилия пользователя.
• Электронная почта: Адрес электронной почты, который также будет использоваться для входа.
• Пароль: Безопасный пароль не менее чем из 6 символов.
• Подтверждение пароля: Повторно введите пароль для проверки.

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

Настройки языка

По умолчанию CLI Lino отображается на английском языке en, но вы можете изменить язык в зависимости от ваших предпочтений, выбрав один из доступных вариантов:

en | pt | es | de | fr | it | ja | ko | ru | zh

Чтобы установить новый язык, выполните следующую команду:

lino preferences culture set --name culture

Кроме того, вы можете выбрать язык с помощью интерактивного списка, выполнив:

lino preferences culture set

Настройка кодировки UTF-8 (необязательно)

Для правильного отображения языков с особыми символами (такими как японский, корейский, русский или китайский), убедитесь, что ваш терминал настроен на использование кодировки UTF-8.

В PowerShell для Windows настройте кодировку, выполнив следующие команды:

[console]::InputEncoding = [System.Text.Encoding]::UTF8

[console]::OutputEncoding = [System.Text.Encoding]::UTF8

Примечание: На системах Linux, macOS и Windows Terminal поддержка UTF-8 обычно является нативной. Однако рекомендуется проверить настройки, если возникают проблемы с отображением символов.

Доступные команды

Lino постоянно развивается, регулярно получая новые команды и функции для удовлетворения потребностей высококачественных проектов .NET.

Чтобы вывести полный список доступных команд, выполните в терминале:

lino

Или, альтернативно:

lino --help

В терминале отобразится список основных команд с кратким описанием каждой, как показано в примере ниже:

COMMANDS:
    project         Команда для управления проектами.
    service         Команда для управления сервисами.
    module          Команда для управления модулями.
    entity          Команда для управления сущностями.
    enumeration     Команда для управления перечислениями.
    value-object    Команда для управления объектами-значениями.
    query           Команда для управления запросами.
    command         Команда для управления командами.
    api             Команда для управления API.
    page            Команда для управления страницами.
    database        Команда для управления миграциями базы данных.
    feature         Команда для управления функциями проекта.
    user            Команда для управления пользователями.
    auth            Команда для управления аутентификацией пользователей.
    preferences     Команда для управления пользовательскими настройками.

Чтобы увидеть подкоманды и конкретные параметры любой команды, используйте:

lino command

Или:

lino command --help

Например, чтобы изучить команду project:

lino project --help

Вы увидите следующее:

DESCRIPTION:
    Команда для управления проектами.

EXAMPLES:
    lino project new --name MyProject
    lino project list

COMMANDS:
    new     Команда для создания нового проекта.
    list    Команда для отображения списка созданных проектов.

В следующем разделе мы рассмотрим, как быстро создать новый проект с помощью Lino.

Быстрый старт

Создайте современное, масштабируемое .NET-приложение, готовое к использованию в крупных проектах, с помощью следующей команды:

lino project new --name MyApp

Эта команда генерирует .NET-решение, структурированное с четким разделением ответственности между слоями, что делает его идеальной основой для надежных и масштабируемых корпоративных приложений.

MyApp/
├── MyApp.sln
├── src/
│   ├── Aspire/
│   │   ├── AppHost/
│   │   │   └── MyApp.AppHost.csproj
│   │   └── ServiceDefaults/
│   │       └── MyApp.ServiceDefaults.csproj
│   └── Services/
│       └── Shared/
│           ├── API/
│           │   └── MyApp.Shared.API.csproj
│           ├── Application/
│           │   └── MyApp.Shared.Application.csproj
│           ├── Domain/
│           │   └── MyApp.Shared.Domain.csproj
│           ├── Infrastructure/
│           │   └── MyApp.Shared.Infrastructure.csproj
│           └── Infrastructure.Persistence/
│               └── MyApp.Shared.Infrastructure.Persistence.csproj
└── tests/
    

Основные преимущества:

• ✅ Структура с четким разделением на слои, соответствующая лучшим практикам современной архитектуры.
• 🔧 Гибкость для масштабирования как микросервис, модульный монолит или традиционное приложение.
• 🚀 Готовые к использованию функции, такие как кеширование, обмен сообщениями и планирование задач.
• 🧱 Надежная основа для применения таких паттернов, как Domain-Driven Design (DDD), Event-Driven Architecture (EDA) и принципы SOLID.
• ✨ Чистый, опинированный и высокопродуктивный код, идеально подходящий для ускорения устойчивой разработки.

С помощью Lino вы ускоряете создание высококачественных .NET-проектов, сочетая продуктивность, архитектурное совершенство и гибкость для поддержания роста вашего приложения.