Этот репозиторий предназначен для активной разработки Azure SDK для Java. Пользователям SDK мы рекомендуем посетить нашу общедоступную документацию для разработчиков или нашу документацию для разработчиков с указанием версий.
Чтобы начать работу с конкретной библиотекой служб, см. файл README.md, расположенный в папке проекта библиотеки. Вы можете найти служебные библиотеки в каталоге /sdk
. Чтобы получить список всех услуг, которые мы поддерживаем, обратитесь к нашему списку всех существующих библиотек.
Учебные пособия, примеры, краткое руководство и другую документацию можно найти на странице Azure для разработчиков Java.
Все библиотеки основаны на Java 8, с тестированием и дальнейшей поддержкой вплоть до последней версии долгосрочной поддержки Java (в настоящее время Java 17).
Каждая служба может иметь как «клиентские», так и «управляющие» библиотеки. «Клиентские» библиотеки используются для использования службы, тогда как «управляющие» библиотеки используются для настройки службы и управления ею.
Наши клиентские библиотеки соответствуют рекомендациям по проектированию Azure SDK для Java и имеют ряд общих функций, таких как повторные попытки HTTP, ведение журнала, транспортные протоколы, протоколы аутентификации и т. д., поэтому, как только вы научитесь использовать эти функции в одной клиентской библиотеке, вы узнаете, как использовать их в других клиентских библиотеках. Вы можете узнать об этих общих функциях здесь. Эти библиотеки можно легко идентифицировать по именам папок, пакетов и пространств имен, начинающихся с azure-
, например azure-keyvault
.
Самый актуальный список всех новых пакетов вы можете найти на нашей странице . В этот список входят самые последние выпуски: как стабильные, так и бета-версии.
ПРИМЕЧАНИЕ. Если вам необходимо убедиться, что ваш код готов к работе, используйте одну из стабильных библиотек, не являющихся бета-версиями.
Как и наши клиентские библиотеки, библиотеки управления соответствуют рекомендациям по проектированию Azure SDK для Java. Эти библиотеки предоставляют объектно-ориентированный API высокого уровня для управления ресурсами Azure, оптимизированный для простоты использования, краткости и согласованности. Список библиотек управления вы можете найти на этой странице .
Общую документацию по использованию новых библиотек для управления ресурсами Azure можно найти здесь . Мы также подготовили множество примеров кода , а также руководство по миграции на случай, если вы обновляетесь с предыдущих версий.
Библиотеки управления можно идентифицировать по пространствам имен, которые начинаются с azure-resourcemanager
, например azure-resourcemanager-compute
.
Обратите внимание, что последние библиотеки Microsoft находятся в идентификаторе группы com.azure
Maven и имеют шаблон именования пакетов, начинающийся с com.azure
. Если вы используете библиотеки, которые находятся в идентификаторе группы com.microsoft.azure
Maven или имеют это в качестве структуры пакета, рассмотрите возможность перехода на последние библиотеки. Таблицу сопоставления этих исторических выпусков с их эквивалентами можно найти здесь.
azure-java-sdk
. Основная ветка содержит самый последний код с новыми функциями и исправлениями ошибок. Он не представляет собой последний выпущенный стабильный SDK.
Для каждого выпускаемого нами пакета будет создан уникальный тег git, содержащий имя и версию пакета, чтобы отметить фиксацию кода, создавшего пакет. Этот тег будет использоваться для обслуживания через ветки исправлений, а также для отладки кода для конкретной бета-версии или стабильной версии. Формат тегов выпуска: <package-name>_<package-version>
. Для получения дополнительной информации ознакомьтесь с нашей стратегией ветвления.
Подробную информацию о добавлении в этот репозиторий см. в руководстве по участию.
Этот проект приветствует вклад и предложения. Большинство вкладов требует от вас согласия с Лицензионным соглашением для авторов (CLA), в котором говорится, что вы имеете право и действительно предоставляете нам права на использование вашего вклада. Дополнительные сведения см. в CLA Microsoft.
Когда вы отправляете запрос на включение, CLA-бот автоматически определяет, нужно ли вам предоставить CLA, и соответствующим образом оформляет PR (например, метку, комментарий). Просто следуйте инструкциям бота. Вам нужно будет сделать это только один раз для всех репозиториев, использующих наш CLA.
В этом проекте принят Кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации см. часто задаваемые вопросы о Кодексе поведения или свяжитесь с нами по адресу [email protected], если у вас возникнут дополнительные вопросы или комментарии.
Многие люди по всему миру помогли сделать этот проект лучше. Вы захотите проверить:
О проблемах безопасности и ошибках следует сообщать в частном порядке по электронной почте в Центр реагирования на безопасность Microsoft (MSRC) [email protected]. Вы должны получить ответ в течение 24 часов. Если по какой-то причине вы этого не сделали, пожалуйста, свяжитесь с нами по электронной почте, чтобы убедиться, что мы получили ваше исходное сообщение. Дополнительную информацию, включая ключ MSRC PGP, можно найти в Техцентре безопасности.
Azure SDK для Java лицензируется по лицензии MIT.