Skip to content

VKCOM/vkid-ios-sdk

Repository files navigation

VK ID SDK Logo

VK ID SDK — библиотека для авторизации пользователей iOS приложений с помощью аккаунта VK ID.


ℹ️ Версии VK ID SDK 2.0.0 и выше поддерживают авторизацию по протоколу OAuth 2.1, а также способы входа через аккаунты Одноклассников и Mail.


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

Общий план интеграции и в целом что такое VK ID можно прочитать здесь.

Чтобы подключить VK ID SDK, сначала получите ID приложения (app_id) и защищенный ключ (client_secret). Для этого создайте приложение в кабинете подключения VK ID.

Требования к приложению и окружению

  • iOS - 12.0 и выше.
  • Swift - 5.9 и выше.
  • Xcode - 15.2 и выше.
↗️ Примечание
Если вы используете в качестве менеджера зависимостей Swift Package Manager
Xcode - 15.3 и выше.

Установка

Swift Package Manager

Добавьте VKID как зависимость в ваш Package.swift:

dependencies: [
    .package(url: "https://github.com/VKCOM/vkid-ios-sdk.git", .upToNextMajor(from: "2.2.0"))
]

CocoaPods

Добавьте в ваш Podfile:

pod 'VKID', '~> 2.2'

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

pod install --repo-update

Более подробно об установке VK ID SDK можно прочитать в статье Как установить SDK.

Демонстрация

SDK поставляется с демо-приложением VKIDDemo, где можно посмотреть работу авторизации и как кастомизируются предоставляемые визуальные компоненты. Для корректной работы демо-приложения укажите параметры CLIENT_ID и CLIENT_SECRET вашего приложения VKID в файле Info.plist.