Руководство. Начало работы с набором средств расширяемости Fabric

Используйте это руководство, чтобы приступить к созданию рабочей нагрузки Microsoft Fabric с помощью набора средств расширяемости. Вы настроили среду, запустите Starter-Kit в GitHub Codespaces или локально, а также изучите основы, необходимые для сборки и публикации.

Что вы строите

Вы запускаете Starter-Kit внутри Fabric, изучаете его манифест и использование хостового API, вносите небольшое изменение в пользовательский интерфейс и понимаете, как элементы, создаваемые вашей рабочей нагрузкой, ведут себя как собственные артефакты Fabric.

Предпосылки

• Доступ к клиенту Fabric и рабочей области, в которой можно создавать элементы
• Учетная запись GitHub (требуется для codespaces)
• При разработке локально: последние версии Node.js LTS и менеджер пакетов (см. README для точного инструмента)
• Доступ к созданию приложения Microsoft Entra
• Необязательно. Подписка Azure, если планируется разместить веб-приложение в Azure

Подсказка

Локальная разработка поддерживается изначально в Windows, macOS и Linux. Перед запуском скриптов установки или запуском сервера разработки просмотрите и выполните необходимые условия в Starter-Kit.

Замечание

Вам не нужно развертывать что-либо в вашем тенанте, чтобы попробовать Starter-Kit. Используйте DevGateway во время разработки для эмуляции узла Fabric.

Это важно

Убедитесь, что у вас есть доступ к рабочей области Fabric и клиенту разрешены функции разработчика. Перед тестированием вы включите режим разработчика Fabric.

Выбор пути

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

Вариант 1. Запуск в GitHub Codespaces

1. Форкните репозиторий Starter-Kit в вашу учетную запись GitHub.
2. Создайте GitHub Codespace на своей форке, чтобы начать работать в облачной среде разработки.

Для получения дополнительной информации о GitHub Codespaces см. документацию по GitHub Codespaces.

Вариант 2. Клонирование и локальное выполнение

1. Сделайте форк репозитория Starter-Kit в вашу учетную запись GitHub.
2. Клонируйте форк на ваш локальный компьютер.

git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit

3. Установите необходимые предварительные требования для локальной разработки:

Необходимые средства:

• Node.js LTS: скачивание Node.js
• PowerShell 7 (pwsh в macOS/Linux): установка PowerShell
• Пакет SDK для .NET (для macOS использует сборку x64): скачайте .NET
• VS Code или аналогичный редактор: скачивание VS Code
• Azure CLI (используется только для создания приложений Microsoft Entra): установка Azure CLI

Разработка с помощью искусственного интеллекта

Этот репозиторий хорошо работает с инструментами программирования пар ИИ. Независимо от того, разрабатываете ли вы локально или в GitHub Codespaces, можно использовать GitHub Copilot или другие помощники ИИ для ускорения задач, таких как редактирование компонентов React, маршрутов обновления или создание шаблонов тестирования.

Подсказка

Репозиторий Starter-Kit с поддержкой ИИ включает инструкции GitHub Copilot, которые помогут вам адаптировать пример Hello World к вашим потребностям. Другие средства ИИ (например, Anthropic Claude) могут выполнять те же рекомендации, но их необходимо настроить для чтения файлов рекомендаций или документов репозитория.

• Используйте ИИ для проектирования компонентов редактора и просмотра элементов, затем адаптируйте их к используемым в Starter-Kit шаблонам API.
• Попросите ИИ суммировать манифест рабочей нагрузки и предложить минимальные наборы разрешений.
• В Codespaces Copilot доступен в браузере или в настольном приложении VS Code; держите сервер разработки в рабочем состоянии, чтобы мгновенно увидеть изменения.

Подсказка

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

Лучшие практики

• Форкните репозиторий: Форкните репозиторий Starter-Kit и используйте свой форк в качестве основы для вашего проекта.
• Поддерживайте синхронизацию: поддерживайте синхронизацию вашего форка с основным репозиторием, чтобы получать улучшения.
• Обеспечение согласованности структуры проекта. Сохраните структуру проекта Starter-Kit и шаблоны организации, чтобы обеспечить совместимость с будущими обновлениями и обеспечить четкость кода.
• Обычная интеграция Starter-Kit: регулярно интегрируйте изменения кода из Starter-Kit в проект, чтобы воспользоваться исправлениями ошибок, новыми функциями и обновлениями системы безопасности. Настройте процесс для регулярного просмотра и объединения изменений из вышестоящего репозитория (ежемесячно или ежеквартально).
• Проверьте манифесты раньше. Проверьте манифест рабочей нагрузки рано и следуйте разрешениям с минимальными привилегиями.
• Используйте контейнеры разработки: используйте контейнеры разработки или Codespaces для согласованной, временной среды.
• Используйте предоставленные скрипты: используйте предоставленные скрипты (setup, StartDevServer, StartDevGateway) для автоматизации установки и ежедневного рабочего процесса.

Дальнейшие шаги

Как только вы получите доступ к коду (в Codespaces или локально), перейдите к подробному руководству по настройке для пошаговых инструкций.

• Запуск скрипта установки
• Запуск среды разработки
• Включение функций разработчика Fabric
• Тестирование первого элемента HelloWorld
• Начало работы с программированием
• Советы по разработке с поддержкой искусственного интеллекта
• Устранение распространенных проблем

Дополнительные ресурсы

• Изучите архитектуру и то, как взаимодействуют между собой хост, ваше приложение и службы Fabric.
• Ознакомьтесь с обзором манифеста для схемы и рекомендаций
• Общие сведения о структуре и конфигурации манифеста рабочей нагрузки
• Разработка с помощью DevGateway для локального тестирования
• Опубликуйте вашу рабочую нагрузку, когда будете готовы поделиться.