Skip to main content
This migration guide covers significant changes in the SDK API that might affect your integration.

​
[8.7.4] to [8.7.5]

​
Android default alert dialogs replaced with new XML layout

A new idenfy_dialog_generic_alert.xml layout was added that replaces the default Android alert dialogs: 
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@color/idenfyDefaultAlertDialogBackgroundColor"
    android:paddingTop="24dp"
    android:paddingStart="24dp"
    android:paddingEnd="16dp"
    android:paddingBottom="24dp">

    <com.idenfy.idenfySdk.uicomponents.IDenfyTextView
        android:id="@+id/idenfy_textview_dialog_generic_title"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:textSize="20sp"
        android:textColor="@color/idenfyDefaultAlertDialogTitleColor"
        app:customfont="hkgrotesk_bold.ttf"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

    <com.idenfy.idenfySdk.uicomponents.IDenfyTextView
        android:id="@+id/idenfy_textview_dialog_generic_message"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="8dp"
        android:textSize="16sp"
        android:textColor="@color/idenfyDefaultAlertDialogMessageColor"
        app:customfont="hkgrotesk_regular.ttf"
        app:layout_constraintTop_toBottomOf="@id/idenfy_textview_dialog_generic_title"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

    <com.idenfy.idenfySdk.uicomponents.IDenfyTextView
        android:id="@+id/idenfy_button_dialog_generic_negative"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:layout_marginEnd="8dp"
        android:paddingStart="16dp"
        android:paddingEnd="16dp"
        android:textSize="14sp"
        android:textAllCaps="true"
        android:textColor="@color/idenfyDefaultAlertDialogNegativeButtonColor"
        android:clickable="true"
        android:focusable="true"
        android:visibility="gone"
        app:customfont="hkgrotesk_bold.ttf"
        app:layout_constraintTop_toBottomOf="@id/idenfy_textview_dialog_generic_message"
        app:layout_constraintEnd_toStartOf="@id/idenfy_button_dialog_generic_positive" />

    <com.idenfy.idenfySdk.uicomponents.IDenfyTextView
        android:id="@+id/idenfy_button_dialog_generic_positive"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:paddingStart="16dp"
        android:paddingEnd="16dp"
        android:textSize="14sp"
        android:textAllCaps="true"
        android:textColor="@color/idenfyDefaultAlertDialogPositiveButtonColor"
        android:clickable="true"
        android:focusable="true"
        app:customfont="hkgrotesk_bold.ttf"
        app:layout_constraintTop_toBottomOf="@id/idenfy_textview_dialog_generic_message"
        app:layout_constraintEnd_toEndOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

​
[8.6.2] to [8.6.3]

​
Updated face capture oval design

Face Oval V2
Follow this migration guide point if you have overridden idenfy_fragment_face_camera_preview_session_v2.xml.
A new idenfy_imageview_face_camera_preview_session_oval_face_v2 oval ImageView was added, which replaces idenfy_imageview_face_camera_preview_session_oval_face in idenfy_fragment_face_camera_preview_session_v2.xml: 
        <ImageView
            android:id="@+id/idenfy_imageview_face_camera_preview_session_oval_face_v2"
            android:layout_width="0dp"
            android:layout_height="0dp"
            android:foregroundGravity="center"
            app:layout_constraintBottom_toTopOf="@+id/idenfy_guideline_camera_preview_session_horizontal_085"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toTopOf="@+id/idenfy_guideline_face_camera_preview_session_horizontal_150" />
The idenfy_imageview_face_camera_preview_session_oval_face is still available but deprecated and will be removed in the future.

​
[8.5.x] to [8.6.0]

​
Added realtime blur glare detection in document capture

Follow this migration guide point if you have overridden idenfy_fragment_document_camera_preview_session_v2.xml.
With the latest realtime blur glare detection feature, a warning alert card was added to idenfy_fragment_document_camera_preview_session_v2.xml: 
        <androidx.constraintlayout.widget.ConstraintLayout
    android:id="@+id/idenfy_document_camera_warning_alert"
    android:layout_width="match_parent"
    android:layout_height="50dp"
    android:layout_gravity="center_vertical"
    android:layout_marginStart="16dp"
    android:layout_marginEnd="16dp"
    android:layout_marginBottom="16dp"
    android:alpha="0.7"
    android:visibility="invisible"
    android:background="@color/idenfyWarningLightYellowV2"
    app:layout_constraintBottom_toTopOf="@+id/idenfy_view_camera_preview_session_bottom_action_buttons"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent">

    <ImageView
        android:id="@+id/idenfy_iv_document_camera_warning"
        android:layout_width="20dp"
        android:layout_height="20dp"
        android:layout_marginStart="16dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:srcCompat="@drawable/idenfy_ic_warning_alert" />

    <com.idenfy.idenfySdk.uicomponents.IDenfyTextView
        android:id="@+id/idenfy_textview_idenfy_iv_document_camera_warning_title"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginEnd="24dp"
        android:theme="@style/idenfyDocumentCameraWarningAlertTitleStyle"
        app:customfont="hkgrotesk_regular.ttf"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toEndOf="@+id/idenfy_iv_document_camera_warning"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

​
[8.5.x] to [8.5.2]

​
KYC Questionnaire FILE and IMAGE questions merged

idenfy_item_questionnaire_type_image_input_v2.xml has been removed.

​
[8.4.x] to [8.5.0]

​
Added Face Detection progress View to the camera drawer

Follow this migration guide point if you have overridden idenfy_partial_layout_face_camera_preview_session_instructions_topsheet_root_v2.xml.
With the latest face authentication auto capture feature, a progress bar was added to idenfy_partial_layout_face_camera_preview_session_instructions_topsheet_root_v2.xml: 
    <ProgressBar
    android:id="@+id/idenfy_progress_bar_face_detection"
    style="?android:attr/progressBarStyleHorizontal"
    android:layout_width="0dp"
    android:layout_height="4dp"
    android:max="100"
    android:progress="0"
    android:visibility="gone"
    android:theme="@style/idenfyFaceCameraPreviewFaceDetectionProgressBarStyle"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"/>
Along with the style: 
    <style name="idenfyFaceCameraPreviewFaceDetectionProgressBarStyle" parent="android:Widget.ProgressBar.Horizontal">
        <item name="colorAccent">@color/idenfyFaceCameraPreviewSessionFaceOvalLoadingColor
        </item>
    </style>

​
[8.3.x] to [8.4.0]

​
Removed Dynamic OnBoarding view

.withConfirmationView(IdenfyOnBoardingViewTypeEnum.MULTIPLE_DYNAMIC) option is no longer available in IdenfyUISettingsV2.
Follow this migration guide point if you have implemented custom views of idenfy_fragment_onboarding_v2.xml or idenfy_fragment_face_authentication_initial_view_v2.
The idenfy_fragment_onboarding_v2.xml and idenfy_fragment_face_authentication_initial_view_v2.xml layouts have changed and no longer have idenfy_cardview_instructions_description, idenfy_constraint_layout_instructions_description, idenfy_iv_instructions_description, idenfy_textview_instructions_description views. You can safely remove them from your layouts. Also, idenfy_colors_camera_dynamic_onboarding_view.xml has been removed. Only idenfyCameraOnBoardingViewBackgroundColor, idenfyCameraOnBoardingViewLoadingSpinnerColor, idenfyCameraDynamicOnBoardingViewProgressBarBackgroundColor and idenfyCameraDynamicOnBoardingViewProgressBarForegroundColor have been moved to idenfy_colors_camera_static_onboarding_view.xml.

​
[8.2.x] to [8.3.0]

​
Removed instructions drawer option from camera view

The instructions drawer has been removed. The top drawer will remain static as if instructions were disabled, and will only hold camera descriptions and the app bar. .withInstructions(IdenfyInstructionsType.DRAWER) option is no longer available in IdenfyUIBuilderV2.
Follow this migration guide point if you have overridden idenfy_partial_layout_face_camera_preview_session_instructions_topsheet_root_v2.xml or idenfy_partial_layout_document_camera_session_instructions_topsheet_root_v2.xml.
The idenfy_partial_layout_face_camera_preview_session_instructions_topsheet_root_v2.xml and idenfy_partial_layout_document_camera_session_instructions_topsheet_root_v2.xml layouts have changed and will no longer hold instructions UI. The layout height is static and is set to @dimen/idenfy_dimen_document_and_face_camera_session_view_drawer_height: 
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/idenfy_constraintlayout_camera_session_instructions_top_sheet_layout_root"
    android:layout_width="match_parent"
    android:layout_height="@dimen/idenfy_dimen_document_and_face_camera_session_view_drawer_height"
    android:background="@drawable/idenfy_custom_drawable_instructions_background_without_rounded_corners"
    android:fillViewport="true"
    android:orientation="vertical">
Many views have been removed from these layouts, and constraints for idenfy_textview_camera_session_instructions_information_title have changed: 
    <com.idenfy.idenfySdk.uicomponents.IDenfyTextView
        android:id="@+id/idenfy_textview_camera_session_instructions_information_title"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="8dp"
        android:layout_marginEnd="16dp"
        android:gravity="center"
        android:textAlignment="center"
        android:theme="@style/idenfyDocumentCameraPreviewTitleStyle"
        app:customfont="hkgrotesk_bold.ttf"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.5"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="@+id/idenfy_guideline_instructions_camera_session_max_collapsed_drawer_height" />
Also, idenfy_partial_layout_camera_session_instructions_topsheet_v2.xml and idenfy_partial_layout_camera_session_instructions_video_view_container_v2.xml have been removed. You can check the new layouts here. All colors and styles related to the instructions drawer have been removed. See the updated colors and styles.