arcgis maps sdk flutter samples

ArcGIS Maps SDK для образцов Flutter

Этот репозиторий содержит пример кода Flutter, демонстрирующий возможности ArcGIS Maps SDK для Flutter и способы их использования в вашем собственном приложении. Этот SDK позволяет разрабатывать кроссплатформенные ГИС-приложения для мобильных устройств под управлением iOS и Android.

Запустите примеры с помощью бета-пакета ArcGIS Maps SDK для Flutter.

Посетите Earlyadopter.esri.com и загрузите пакет ArcGIS Maps SDK для Flutter. Следуйте инструкциям, чтобы распаковать его.

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

 parent_directory
   |
   |__ arcgis-maps-sdk-flutter-samples
   |
   |__ arcgis_maps_package

Перейдите в каталог arcgis-maps-sdk-flutter-samples .

 cd arcgis-maps-sdk-flutter-samples

Используйте flutter pub upgrade для настройки зависимостей.

 flutter pub upgrade

Установите arcgis_maps_core.

Примечание для Windows: для этого шага требуется разрешение на создание символических ссылок. Либо запустите этот шаг в командной строке «Администратора» с повышенными правами, либо перейдите в «Настройки > Обновление и безопасность > Для разработчиков» и включите «Режим разработчика».

 dart run arcgis_maps install

Теперь вы готовы запустить пример приложения!

Запуск приложения «Образцы»

Приложение можно запустить на симуляторе или устройстве iOS или Android. Примечание. Чтобы в полной мере воспользоваться примерами в приложении, вам потребуется настроить ключ API. См. Настройка ключей API.

• Откройте проект флаттера в VSCode.
• Убедитесь, что симулятор запущен или устройство подключено к вашей машине разработки.
• Откройте боковую панель «Запуск и отладка».
• Выберите, какое устройство или симулятор вы хотите использовать, в правом нижнем углу окна VSCode.
• Выберите «Пример приложения Viewer (отладка или выпуск)».
  • Обратите внимание, что «Sample Viewer App (выпуск)» можно запустить только на устройстве.
• Нажмите кнопку «Выполнить» или нажмите F5.

Запуск отдельных образцов

Отдельные образцы также можно запускать на симуляторе или устройстве iOS или Android.

• Откройте проект флаттера в VSCode.
• Убедитесь, что симулятор запущен или устройство подключено к вашей машине разработки.
• Выберите, какое устройство или симулятор вы хотите использовать, в правом нижнем углу окна VSCode.
• Чтобы запустить из VSCode, откройте lib/utils/sample_runner.dart и определите образец, который вы хотите запустить.
• Или запустите из командной строки с помощью flutter run lib/utils/sample_runner.dart --dart-define=SAMPLE=display_map

Настройка ключей API

Чтобы в полной мере воспользоваться примерами в приложении, вам необходимо сгенерировать токен доступа к ключу API. Следуйте инструкциям по созданию ключа API. Убедитесь, что для служб определения местоположения установлены значения «Базовая карта», «Геокодирование» и «Маршрутизация» . Скопируйте ключ API, поскольку он будет использоваться на следующем шаге.

Добавьте новый ключ API непосредственно в main.dart или создайте JSON-файл среды, который можно загрузить с помощью аргумента командной строки --dart-define-from-file flutter run .

Сам файл JSON должен иметь формат:

 {
    "API_KEY": "your_api_key_here"
}

Чтобы запустить приложение Sample Viewer с использованием файла JSON для определения ключа API:

 flutter run --dart-define-from-file=path/to/json/file.json

Лицензирование

Авторские права Esri, 2024 г.

Лицензия Apache версии 2.0 («Лицензия»); вы не можете использовать этот файл, кроме как в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу:

http://www.apache.org/licenses/LICENSE-2.0

Если это не требуется действующим законодательством или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, распространяется на условиях «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ ИЛИ УСЛОВИЙ, явных или подразумеваемых. См. Лицензию для определения конкретного языка, регулирующего разрешения и ограничения в рамках Лицензии.

Копия лицензии доступна в файле LICENSE репозитория.