README_RU.md

Flida Android SDK

Официальный Android SDK для интеграции аутентификации Flida в ваши Android-приложения.

Установка

JitPack

1. Добавьте репозиторий JitPack в ваш settings.gradle (или корневой build.gradle):

   dependencyResolutionManagement {
       repositories {
           google()
           mavenCentral()
           maven { url 'https://jitpack.io' }
       }
   }

2. Добавьте зависимость в build.gradle вашего приложения:

   dependencies {
       implementation 'com.github.flida-dev:android-sdk:Tag' // Замените 'Tag' на последнюю версию (например, 1.0.0)
   }

Настройка

1. Настройка Manifest

Вам необходимо настроить redirect activity в AndroidManifest.xml для обработки ответа аутентификации. SDK уже включает FlidaRedirectActivity, который автоматически объединяется с вашим манифестом. Вам нужно только указать flidaAuthHost placeholder в вашем build.gradle.

В build.gradle вашего приложения:

android {
    defaultConfig {
        // ...
        manifestPlaceholders = [
            flidaAuthHost: "YOUR_CLIENT_ID.api.flida.dev" // Замените на ваш реальный хост
        ]
    }
}

2. Инициализация

Инициализируйте SDK в вашем классе Application или MainActivity.

import dev.flida.sdk.FlidaIDSDK

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // Инициализация
        val sdk = FlidaIDSDK.initialize(this)
        
        // Конфигурация
        sdk.configure(
            clientId = "YOUR_CLIENT_ID",
            scopes = listOf("openid", "name", "e-mail-address", "phone-number")
        )
    }
}

Использование

Авторизация (Authorize)

Чтобы запустить процесс входа:

FlidaIDSDK.shared.authorize(this) { result ->
    result.fold(
        onSuccess = { tokenResponse ->
            println("Access Token: ${tokenResponse.token.accessToken}")
        },
        onFailure = { error ->
            println("Error: ${error.message}")
        }
    )
}

Получение информации о пользователе (User Info)

После авторизации вы можете получить данные пользователя:

FlidaIDSDK.shared.getUserInfo { result ->
    result.fold(
        onSuccess = { user ->
            println("User Name: ${user.name}")
            println("User ID: ${user.id}")
        },
        onFailure = { error ->
            println("Error: ${error.message}")
        }
    )
}

Обновление токена (Refresh Token)

Чтобы обновить access token:

FlidaIDSDK.shared.refreshToken { result ->
    // Обработка результата
}

Выход (Logout)

Чтобы очистить сессию:

FlidaIDSDK.shared.logout()