> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/sdk-mobile/ios-sdk/changelog.md).

# Changelog

**Nota:** A biblioteca **Licensing** está obsoleta; sua funcionalidade foi incluída em **SDK Main** desde a versão v2.4.X.

***

### Última versão

**Versão:** 2.8.1\
**Junho de 2026**

#### Geral

* Release parcial de componentes com atualizações requeridas.

#### Phingers - Captura de Impressão Digital

* **Mudança incompatível:** o parâmetro **`threshold`** é substituído por **`livenessThreshold`** e **`detectorThreshold`** em **`PhingersConfigurationData`**. O valor padrão passa de **0.7** a **0.9** em ambos os parâmetros.
* **Mudança incompatível (comportamento):** **`enableFlash`** pode ser ativado mesmo que esteja em `false` se o processo detectar pouca luz na imagem para melhorar o processo de captura.

#### SelphID - Captura de Documento

* Novo parâmetro **`animateDismiss`** em **`SelphIDConfigurationData`**: indica se o fechamento do SDK é animado ao finalizar o processo.

#### Selphi - Captura Facial

* Novo parâmetro **`animateDismiss`** em **`SelphiConfigurationData`**: indica se o fechamento do SDK é animado ao finalizar o processo.

#### Chamada de vídeo

* **Mudança incompatível / migração:** a **extensão de compartilhamento de tela** (Broadcast Upload Extension) passa a ser configurada no componente **Chamada de vídeo**. O aplicativo integrador deve criar a extensão e passar seu **`extensionIdentifier`** ao iniciar **`VideoCallController`**. Consulte a [documentação do módulo](/docs.facephi-pt-br/sdks/sdk-mobile/ios-sdk/modulos/videollamada.md#extension-de-compartir-pantalla).

***

### Versões anteriores

#### Versão: 2.8.0

**Maio de 2026**

#### Geral

* Versão menor do **Core atualizada para 2.8.0** e publicação alinhada de componentes **2.8.0** onde aplicável.
* **Mudança incompatível (personalização de recursos):** a chave da cor de fundo do SDK passa de `sdkBackgroundColor` a **`sdkBackgroundPrimaryColor`**; é preciso atualizá-la ou o tema não aplicará o fundo esperado. Também é adicionada **`sdkBackgroundSecondaryColor`** (entre outros usos, na tela do seletor de documentos do SelphID).
* **Mudança incompatível (personalização de recursos):** o recurso `ic_sdk_logo` é renomeado para `sdk_logo` em todos os componentes. Afeta integradores que personalizam recursos.

#### Selphi - Captura Facial

* Atualizada a dependência do widget **Selphi**; nova versão do widget: **6.2.0**.
* **Correção:** se limpa a cache de personalização do **Fluxo** ao inicializar o controlador (evita estilos residuais entre instâncias).

#### SelphID - Captura de Documento

* Atualizada a dependência do widget **SelphID**; nova versão do widget nesta entrega: **1.39.1**.
* **Correção:** se limpa a cache de personalização do **Fluxo** ao inicializar o controlador (evita estilos residuais entre instâncias).

#### Capture - Upload de arquivos / captura

* **Mudança incompatível:** em **`FileUploaderConfigurationData`** são adicionados **`onlyGalleryMode`** (por padrão **`true`**) e **`maxGalleryImageSizeKb`** (por padrão **2048**).
* **Correção:** o envio de dados para **tracking** usa o **tipo MIME** resolvido a partir do resultado do widget (incluindo seleção da galeria), em vez de assumir sempre PDF ou imagem genérica.

#### Phingers - Captura de Impressão Digital

* **Correção:** correção da seleção de tutoriais de acordo com o modo de captura por dedo.

#### NFC 2.16.0 - Leitura de documento NFC

* **Funcionalidade:** suporte a imagens no formato **JPEG2000** em **DG2** e **DG7**.
* **Correção:** a UI de **tutorial** respeita o flag **`showTutorial`** (deixava de ser aplicado ao estar forçado a `true`).
* **Diagnóstico:** ampliação dos **logs** em **DG2** para facilitar o suporte e a depuração.

#### Chamada de vídeo

* **Mudança incompatível:** dependência de **streaming de vídeo** atualizada por mudanças breaking do SDK nativo (configuração de *frame rate* do encoder e versão mínima do SDK).

#### VideoID - Identificação por vídeo

* **Mudança incompatível:** dependência de **streaming de vídeo** atualizada por mudanças breaking do SDK nativo (configuração de *frame rate* do encoder e versão mínima do SDK).
* **Correção:** tratamento explícito de **erros de rede** no fluxo.
* **Correção:** o progresso da Captura Facial é preservado **da Captura Facial** ao mudar de modo (por ex., só rosto frente a fluxos mistos).
* Atualizado e adaptado **FPHISelphidDocumentReaderBundle** a **2.1.0**.

#### Gravação de vídeo

* **Mudança incompatível:** dependência de **streaming de vídeo** atualizada por mudanças breaking do SDK nativo (configuração de *frame rate* do encoder e versão mínima do SDK).
* **Mudança incompatível:** novo parâmetro de configuração **`enableAudio`**. Seu valor padrão é **`false`**.
* **Correção:** possível **vazamento de memória** por retenção cíclica em **`VideoRecordingController`**.
* **Correção:** refatoração relacionada com **áudio** e **upload** após a atualização da dependência de **streaming de vídeo**.

#### Tracking - Conexão com a plataforma

* Atualização da dependência do componente **Tracking** relacionada à identificação de dispositivo (2.6.0 → 2.14.x).
* As credenciais podem ser resolvidas a partir da configuração da licença nos componentes **Tracking** ou **IDV**, conforme a implantação.
* Novos metadados no envio de eventos de tracking: **versão do SDK** em *tags* e **`operationId`** em **LinkedId** onde aplicável.

#### Status

* **Correção:** cor de fundo do elemento de "descrição" no diagnóstico de **Permission's**..

***

#### Versão: 2.7.X

**Março de 2026**

#### Geral

* Versão menor do Core atualizada para 2.7.0 (SDK Main)
* A distribuição via SPM agora exporta binários hospedados em Artifactory. Os integradores devem incluir suas credenciais no arquivo `.netrc` para baixá-los.
* Melhorado o tratamento de erros de rede e o feedback para o aplicativo do integrador.

#### Selphi - Captura Facial

* Envio do identificador de flavor do widget para a plataforma.
* Correção: o vídeo capturado não é excluído automaticamente após salvar seus dados no resultado.
* Adicionado suporte para IAD em IDV.

#### SelphID - Captura de Documento

* Funcionalidade: adicionado seletor de documento e país. Esse seletor é uma view UI personalizável que permite ao usuário escolher o tipo de documento e o país emissor.
* Novos parâmetros em **SelphIDConfigurationData**:

```
showDocumentSelector: Bool? -> valor padrão false
enabledCountries: [String]? -> lista de países especificada em ISO2
enabledDocumentTypes: [SelphIDDocumentType]? -> valor padrão [.ID_CARD, .PASSPORT, .FOREIGN_CARD, .DRIVERS_LICENSE]
```

#### VoiceId - Captura de voz

* Envio do identificador do widget e da versão do widget para a plataforma.

***

#### Versão: 2.6.X

**Fevereiro de 2026**

#### Geral

* Versão menor do Core atualizada para 2.6.0 (SDK Main)

#### Tracking - Conexão com a plataforma

* Corrigido o parsing do mapa de **Steps**

#### Selphi - Captura Facial

* Atualizada a dependência de Selphi para resolver o problema de navegação em branco em IAD
* Nova versão do widget: 6.0.2

#### SelphID - Captura de Documento

* Atualizada a dependência de Core e refatorado **SDK\_TIMEOUT**
* Adicionado **DOC\_TYPE** a **FlowController extraData**
* Nova versão do widget: 1.37.0
* Corrigida referência a arquivo inexistente

#### Phingers - Captura de Impressão Digital

* Adicionado suporte para detecção de múltiplos rostos
* Refatorado **DetectFaceServiceProtocol** para soluções nativas e baseadas em helper
* Movida a lógica de **RecognitionHelper** para seu próprio serviço; refatorada a inicialização de **GlobalSettings** e **ReaderHelper**
* Corrigido literal em português para “Cancel”
* Revertido o uso do serviço Reader e restaurada a implementação legada com funcionalidades nativas

#### VoiceId - Captura de voz

* Modificados os textos de acessibilidade (voice-over) na tela de gravação para melhorar a UX

#### Chamada de vídeo

* Corrigido literal incorreto para a ação Cancel no modal “Are you sure you want to close?” para localizações em português

#### VideoID - Identificação por vídeo

* Atualizada a versão de **FPHISelphidDocumentReaderBundle** para corrigir vazamento de memória
* Adicionado suporte para detecção de múltiplos rostos
* Refatorado **DetectFaceServiceProtocol** para soluções nativas e baseadas em helper
* Movida a lógica de **RecognitionHelper** para seu próprio serviço; refatorada a inicialização de **GlobalSettings** e **ReaderHelper**
* Corrigido literal em português para “Cancel”
* Revertido o uso do serviço Reader e restaurada a implementação legada com funcionalidades nativas

#### Gravação de vídeo

* Refatorada a gestão de erros no método **início**
* Melhorado o tratamento de erros e o reporting de tracking
* Adicionado suporte para usar **integrationId** de **TrackingConfigurationData sharedContainer** passa a ser um parâmetro opcional em vez de implicitamente desembrulhado
* Corrigido que a feature **DEMOS** não suportava a injeção de **integrationId** em VideoRecording
* Corrigido problema pelo qual VideoRecording parava após concluir NFC quando o modal nativo do iOS era fechado durante o fluxo IDV

***

#### Versão: 2.5.X

**Dezembro de 2025**

#### Geral

* Mudança incompatível: **ErrorType.TIMEOUT** foi renomeado para **ErrorType.SDK\_TIMEOUT** (SDK Core)
* Versão menor do Core atualizada para 2.5.0 (SDK Main)
* Os fluxos IDV podem ser retomados usando os novos parâmetros **resumeOperationId** e **resumeSessionId** (SDK Main)

#### Tracking - Conexão com a plataforma

* Nova versão do widget: 1.1.25
* Versão menor do Core atualizada para 2.5.0
* Adicionado suporte para **IDV Proxy**
* Adicionado suporte para a etapa de **NFC** em IDV
* Corrigido o parâmetro **steps** na função **newOperation**, que não era parseado corretamente em alguns casos de uso
* Adicionado **Privacy Manifest** para evitar erros ITMS ao enviar o app para a App Store

#### Selphi - Captura Facial

* Versão menor do Core atualizada para 2.5.0\
  Criado novo flavor **FPHISDKSelphiIADComponent** para prevenir ataques de injeção

#### SelphID - Captura de Documento

* Nova versão do widget: 1.36.3
* Versão menor do Core atualizada para 2.5.0
* Adicionados parâmetros capturados ao Fluxo para usá-los como entrada do leitor NFC de documentos

#### Tokenizar

* Versão menor do Core atualizada para 2.5.0

#### Phingers - Captura de Impressão Digital

* Versão menor do Core atualizada para 2.5.0
* Versão maior de **SelphID Document’s Reader (SDR)** para 2.0.0
* Refatorado **ErrorType.TIMEOUT** a **ErrorType.SDK\_TIMEOUT**
* Novos modos (**VideoIdMode.DOCUMENT\_FRONT** e **VideoIdMode.DOCUMENT\_FRONT\_BACK**) para captura apenas de documento

#### VoiceId - Captura de voz

* Versão menor do Core atualizada para 2.5.0
* Refatorado **ErrorType.TIMEOUT** a **ErrorType.SDK\_TIMEOUT**

#### Chamada de vídeo

* Versão menor do Core atualizada para 2.5.0
* Refatorado **ErrorType.TIMEOUT** a **ErrorType.SDK\_TIMEOUT**
* Corrigido evento de tracking duplicado ao lançar o diagnóstico

#### VideoID - Identificação por vídeo

* Versão menor do Core atualizada para 2.5.0
* Versão maior de **SelphID Document’s Reader (SDR)** para 2.0.0
* Refatorado **ErrorType.TIMEOUT** a **ErrorType.SDK\_TIMEOUT**
* Novos modos (**VideoIdMode.DOCUMENT\_FRONT** e **VideoIdMode.DOCUMENT\_FRONT\_BACK**) para captura apenas de documento

#### Gravação de vídeo

* Versão menor do Core atualizada para 2.5.0
* Refatorado **ErrorType.TIMEOUT** a **ErrorType.SDK\_TIMEOUT**
* Adicionado timestamp na parte inferior das gravações de vídeo
* Corrigido que a gravação parasse após finalizar a leitura NFC no fluxo IDV
* Corrigido crash quando o componente era utilizado com licença vazia

***

#### Versão: 2.4.X

**Outubro de 2025**

#### Geral

* Adicionado **integrationId** como parâmetro obrigatório (não omitível); adicionado a **TrackingConfigurationData** (SDK Core)
* Removido evento único desnecessário **sendAdvanceTracking** (SDK Core)
* Adaptadas funções de **ITrackingController** para funcionar com fluxos IDV (SDK Core)
* Criadas extensões **Data** e **FileManager**; refatorado **ITrackingController** (SDK Core)
* Refatorado **NO\_OPERATION\_CREATED\_ERROR → OPERATION\_NOT\_CREATED** (SDK Core)
* Retornado **OcrDiagnostic** em **OCR\_ERROR** em VideoID (SDK Core)
* Atualizado **LicenseChecker** para v2.3.3 (SDK Core)
* Corrigidos **attributedText** e **setBold()** em **UITextView** (SDK Core)
* Retornado **operationId** em cada **SdkFlowResult** (SDK Main)
* Atualizada dependência Core para v2.3.3; removidos **flowPreview** e **cache** em **GetFlowService** (SDK Main)
* Adicionado **integrationId** para **VideoRecording**; evento **finish flow change\_step** (SDK Main)
* Método público para recuperar IDs e tipos de Fluxo; classes refatoradas para o diretório **Data** (SDK Main)
* Removidos **activateFlow** e **iaModels** de **initSdk()**; **FlowData IDs** e **operationType** públicos (SDK Main)
* Refatorados **SDKController** e **Fluxo**; **IdvLicense**; **LicensingComponent** interno (SDK Main)
* Novo método público de personalização; correções para **operationId**, **customization.colors**, **licensing check**, **step reference** (SDK Main)

#### Tracking - Conexão com a plataforma

* Limpeza e refatoração do código e dos modelos internos
* Atualizados eventos de **TrackingController** e chamadas a assets; **trackingWidget v1.1.19 → v1.1.22**
* Adicionado **authenticationId**; **Core v2.3.3**; **integrationId** em **configurationData**
* Removido evento único desnecessário **sendAdvanceTracking**
* Detecção automática de país em **sendDocumentData**; tracking completo de IDV
* Refatorado **NO\_OPERATION\_CREATED\_ERROR → OPERATION\_NOT\_CREATED**; SDK v2.4.0
* Adaptado a **Tracking v1.0.16** para melhorar a estabilidade

#### Selphi - Captura Facial

* Widget com personalização completa; **setParam** para **UseSdkCustomization**
* Nova versão do widget: **5.19.2**
* **AuthenticationId**; inclusão condicional de **includeClip**; **ACTIVE\_LIVENESS\_ERROR**; **livenessDiagnostic** em **SELPHI\_TIMEOUT**
* Release IDV v2.4.0; **SelfieData** para Tracking IDV; **LivenessDiagnostic** em Core
* Core v2.3.3; Widget e **SelphiKMP** atualizados; removido **cameraId**
* **sendSelfie** em success; erros unificados em Tracking; Integração **SelphiKMP** e **KMP Widget**
* Refactors: lógica, gestão de erros, estrutura de pastas, **SelphiWidgetController.start()** para Licença inválida
* Correções: **stepData**, **videoFilename**, **liveness** em Tracking, modo **MOVE**, **bestImage**, conflitos com Core

#### SelphID - Captura de Documento

* Nova versão do widget: **1.35.2**; Personalização completa; **setParam** para **UseSdkCustomization**
* Adaptado a **trackingWidget v1.1.23**; **generateRawImages** por padrão **true**
* Flag de Inicialização sempre **true**; correções em **stepData** e **generateRawImages null**

#### Tokenizar

* Primeira Release **v2.4.0**
* Fonte estabelecida **fpbtokenizer** de **clienters** para o comportamento correto da Inicialização

#### Phingers - Captura de Impressão Digital

* Atualizado e adaptado ao último **trackingWidget**; **SDR v1.8.0**; **trackAssets** para IDV
* **sendVideoIdData**; renomeado **matchingSidesScore**; removido **OcrDiagnostic** duplicado; unificado **Core OCR\_ERROR**
* Melhorado **ErrorParser**; primeira versão estável **v2.4.0**; **Core v2.3.3**
* Ajustado o limiar mínimo de tamanho facial para captura com máscara
* Correções: **IdvResultData** somente em erro terminal; **stepData**; tratamento de **NETWORK ERROR**

#### VoiceId - Captura de voz

* versão do SDK **5.3.0**; **ErrorParser** com **toNameError**, **toCodeError**, **toReasonError**
* Core v2.3.3; processo **Matching** deprecated (já não suportado Matching local); primeira versão **v2.4.0**
* Revisão UX de layout e acessibilidade; correção em **stepData**

#### Chamada de vídeo

* Atualizado e adaptado ao último **trackingWidget**; **ErrorParser** (**toNameError**, **toCodeError**, **toReasonError**)
* Core v2.3.3; revisão geral UX para animações, literais e flow
* Correções em **stepData**; correções em nomes de literais e animações

#### VideoID - Identificação por vídeo

* Atualizado e adaptado ao último **trackingWidget**; **SDR v1.8.0**; **trackAssets** para IDV
* **sendVideoIdData**; renomeado **matchingSidesScore**; removido **OcrDiagnostic** duplicado; unificado **Core OCR\_ERROR**
* Melhorado **ErrorParser**; primeira versão estável **v2.4.0**; **Core v2.3.3**
* Ajustado o limiar mínimo de tamanho facial para captura com máscara
* Correções: **IdvResultData** somente em erro terminal; **stepData**; tratamento de **NETWORK ERROR**

#### Gravação de vídeo

* Removido **presenter**; código de retorno **VIDEO\_RECORDING\_ACTIVE**; saída em **STOPVRController**
* **integrationId** em serviços; **StopVideoRecordingController** para IDV; **Core v2.3.3**
* Correções em **stepData** e corner case com instância ativa

***

#### Versão: 2.3.X

**Junho 2025 / Julho 2025**

#### Geral

* **License Manager 0.5.5**; **LicenseChecker** atualizado (SDK Core)
* **AnalyticsManager** refatorado e otimizado; **StepData** e **ITrackingController** refatorados (SDK Core)
* Função auxiliar **Locale.swift**; **AnalyticsManager** e eventos analytics (SDK Core)
* Analytics para **Status** e **CheckPermissions**; **Core 2.3.0**; analytics em **IStatusController** (SDK Core)
* Locale/language a partir de **initSdk()**; **AnalyticsManager → IAnalyticsController** (SDK Core)
* Correção do import **Foundation** (SDK Core)
* Renomeado **AnalyticsManager**; **License Manager 0.5.5**; **Core v2.3.2** (SDK Main)
* Criptografia IDV (desde 2.3.1); analytics completos em SDK; language a partir de **initSdk()** (SDK Main)
* **integrationId** opcional em **initSdk()**; **FlowPreviewController**; **FlowOffline**; operação injetável (SDK Main)
* Refatoração **AnalyticsManager → IAnalyticsController** (SDK Main)
* Correções: injeção **initSdk**, personalização da cor do flow, **ColorFlowKeys**, **PR #90** (SDK Main)

#### Licensing

* Core atualizado para **v2.3.2**; protocolo **HTTP → SSH**
* Correção da dependência Core em cache durante a geração

#### Tracking - Conexão com a plataforma

* **Core v2.3.2**; novos **TrackingWidgetErrors**; **idv** em **TrackingLicense**
* **tracking-widget-kmp v1.1.8**; interface **TrackingController**; **TrackingXWidgetController** para IDV
* **TrackingWidget 1.1.7 → 1.1.5**; integração aprimorada de identificação de dispositivos; SPM para **FPHITrackingWidget-SPM**
* Refatoração **sendAdvTracking()**; testes com IDV
* Correções: **TrackingError public**, enum asset, thread em segundo plano, desajuste de versões entre Core e Tracking, crash **initOperation v3**, ajuste de **constraints**

#### Selphi - Captura Facial

* Commit reversível com comentários/logs para auditoria; versão acessível (SDK Main 2.3)
* **License Manager 0.5.5**; revisão completa de acessibilidade; **Core v2.3.1**
* Tracking de assets de vídeo com IDV; locale a partir de **initSdk()**; Integração de analytics
* Core v2.3.0; português; language a partir de **initSdk()**; event tracking a partir do Widget
* **hasOperationCreated** antes de **createStep()**; **AnalyticsManager → IAnalyticsController**

#### SelphID - Captura de Documento

* Widget **1.35.0, 1.34.7, 1.34.6**; **Core v2.3.3**; **MBSDR arm64**; **Widget 1.34.4 → 1.34.6**
* Widget **1.34.3**; scheme **MBSDR**; **SelphIDWidget 1.33.4**; nomenclatura **selphidComponent.xcframework**
* Refatoração **AnalyticsManager** (reversível); **Core v2.3.2**; **Widget 1.33.1**
* Imagens como **JPEG 95%**; testes IDV e tracking de assets de vídeo; **SelphIDWidget 1.32.1 → 1.32.2**
* **Package-RGL-template**; SPM para **RGL**; **Core v2.3.0**; parsing **licenseManager**; locale do dispositivo
* Correções: literais/animações, **Podfile/MBSDR**, reverter analytics, compressão, **hasOperationCreated**, enums, **AnalyticsManager → IAnalyticsController**, configuração

#### Tokenizar

* **Core v2.3.2, v2.3.1, v2.3.0**
* Adicionada validação de dados vazios antes de enviá-los para **Core Tokenizer** para evitar crashes

#### Phingers - Captura de Impressão Digital

* Dependência **Reader** e modelos; **documentFaceImageMapTokenized**; chaves **OcrMap FRONT/BACK**
* **isReadyToRecord**; modo **FACE + FRONT**; **documentFullImage**; constantes **2.3.17**; tamanho reduzido
* **documentQualityThreshold**, **faceQualityThreshold**; **TrackAssetsService**, **GetReaderModelsService**
* **Core v2.3.2**, **Reader v1.5.0**; **DetectDocumentService** e OCR; animações e UX; **UIFontMetrics**
* Dependências **SDR**; lógica de troca de lado; overlay de captura de documento; captura de voz; **Core Analytics v2.3.0**
* Catalão, Português (PT/BR), Espanhol; correções FRONT/BACK, thread em segundo plano, vazamentos de memória, capturas, literais, **AnalyticsManager → IAnalyticsController**

#### VoiceId - Captura de voz

* **Core v2.3.2**; **UIFontMetrics** para escalonamento dinâmico de texto; analytics e eventos Tracking
* **Core v2.3.0**; correção do Lottie; logging do componente; **Voices SDK**; unificado com Android
* Controle prévio de dicas e feedback háptico; correção **hasOperationCreated** antes de **createStep**; **AnalyticsManager → IAnalyticsController**

#### Chamada de vídeo

* **2.3.5**: redução do tamanho do componente e do peso binário; melhoria do compartilhamento de tela; correção do mute durante o compartilhamento de tela
* **2.3.3**: **Core v2.3.2**
* **2.3.2**: **UIFontMetrics**; correção **hasOperationCreated** e **fromNib main thread**; **AnalyticsManager → IAnalyticsController**
* **2.3.0**: analytics em SDK; **Core v2.3.0**; unificado com Android; Catalão e Português; language a partir de **initSdk()**; melhorias de layout

#### VideoID - Identificação por vídeo

* Dependência **Reader** e modelos; **documentFaceImageMapTokenized**; chaves **OcrMap FRONT/BACK**
* **isReadyToRecord**; modo **FACE + FRONT**; **documentFullImage**; constantes **2.3.17**; tamanho reduzido
* **documentQualityThreshold**, **faceQualityThreshold**; **TrackAssetsService**, **GetReaderModelsService**
* **Core v2.3.2**, **Reader v1.5.0**; **SDR**; lógica de troca de lado; overlay de captura de documento; captura de voz; **Core Analytics v2.3.0**
* Catalão, Português (PT/BR), Espanhol; correções FRONT/BACK, thread em segundo plano, vazamentos de memória, capturas, literais, **AnalyticsManager → IAnalyticsController**

#### Gravação de vídeo

* Timestamp na metadata de gravação; **Core v2.3.2**; serviço **stopCapture**
* Removida referência **Resources** e extensão de gravação de tela; **Core v2.3.1**
* Eventos: **COMPONENT\_START**, **STOP**, modal de permissão de compartilhamento de tela; **Core v2.3.0**
* Correção do nome do componente, modal de permissões; **AnalyticsManager → IAnalyticsController**

***

#### Versão: 2.2.X

**Janeiro 2025 / Março 2025**

#### Geral

* Atualizações **ThemeManager** e **UIView**; **LicenseChecker v2.2.0**; **SdkColor** com **UIColor** (SDK Core)
* **StepData** e **stepData** em **ITrackingController**; **sendAdvanceTracking** (SDK Core)
* Correção **Test.podspec 2.2.1**, **UIColor(hex:)**; limpeza da interface **Status** (SDK Core)
* Personalização da interface Flow (SDK Core 2.1); correção **IDiagnosticView Main Thread** (SDK Core 2.1)
* Atualizado **Core v2.2.2**; licenciamento; **PR #89**; **Tracking StepData screensharing** (SDK Main)
* Removido **flow preview**; **json → jsonX**; correção de persistência da configuração do flow; manifest **Package-template** (SDK Main)
* **fix\_customization\_flow**; revertidas mudanças incorretas; lógica removida **flow preview**

#### Licensing

* Estabilidade Core e **v2.2.0**; lógica de validação success/failure removida
* Correção **Tracking StepData screensharing**

#### Tracking - Conexão com a plataforma

* **XCFrameworks v1.1.0 → v1.1.2**; constantes **2.2.1**; **sendAdvanceTrackingEvent()**
* Novo parâmetro Debug; dois novos erros widget; **Core v2.2.0**
* **TrackingControllerKMP**; Widget KMP; **trackingWidget v1.0.1**; **LocationManager**
* Refatoração **TrackingError**; workaround Core antigo
* Correções: crash **advanceTracking()**, **setTrackingError before start()**, compilação, race condition, **tenantId private**

#### Selphi - Captura Facial

* Idioma padrão = dispositivo; flash da câmera traseira; **Core (SM-4399)**; **Widget v5.16.3**
* **Back Camera MOVE mode**; **cameraPreferred**; **SelphiWidget v5.16.0**
* Lotties acessíveis; navegação e feedback; **PR #74 UX**; encapsulamento de erros
* **RawTemplateWidgetController**; **FPBLivenessDiagnostic**; Advance Tracking; **Core v2.2.0**
* Personalização de animações; **PR #69 literal/UI**; **TutorialTipsConfigurationData** e constantes
* Correções: launch background thread, navegação, crashes de captura do Widget

#### SelphID - Captura de Documento

* **Core v2.2.2**; **SelphIDWidget v1.31.0 → v1.31.2**; Lotties acessíveis
* **dismissViewController**; produto/workspace **MLRGL**; **Core v2.2.1**; parâmetros VISA
* **Widget v1.27.2 → v1.28.1**; **SDR v0.32.2**; **Widget v1.27.0**; **TVeryLong → VERY\_LONG**
* **selphIDResult.statistics** para demo Advance Tracking; botão de info do tutorial; Personalização completa
* **Core v2.2.0**; flow somente tutorial
* Correções: ponteiro **MLRGL**, **StepData screensharing**, **Widget v1.28.2**

#### Tokenizar

* Última versão **FPBTokenizer**; compatibilidade Core; dependência Tokenizer e breaking changes; **Core v2.2.0**
* Corrigir erro **Tracking StepData** durante o compartilhamento de tela

#### Phingers - Captura de Impressão Digital

* **autoFaceDetection** e botão da câmera; seleção da câmera e fontes personalizadas; barra de progresso e UX
* Modo escuro; navegação de diagnósticos; refatoração **VideoIdSteps**
* Timeout e imagem colorida personalizada; fallback de timeout de 3 segundos; rotação da imagem e **StepData**
* **Core v2.2.0**; detecção facial e modo sem tutorial; literais
* Correções: **cameraPreferred**, passos da UI, conflitos do Core, **successResponse**, literais de detecção facial e assinatura

#### VoiceId - Captura de voz

* Core atualizado; suporte a cor do Modo escuro; parâmetro **minSpeechLength**
* Logs e verificações do microfone; warning **MultipleSpeakers** se **enableQualityCheck = false**
* **Voice SDK v4.1.0**; animações personalizadas; refatoração do tutorial (flow baseado em estado)
* Timeouts e dismiss apenas em **retryAction**
* Correções: navegação **TIMEOUT**, cancelar/reiniciar gravação, **StepData screensharing**, **VoiceEnvironment**, **PrivacyInfo.xcprivacy**

#### Chamada de vídeo

* **2.2.5**: Core latest; fontes personalizadas e toggle da câmera; **VideoCallController**; cores do modo e ícones; **timeoutDispatcher**
* **2.2.3**: tela de retry e recuperação da conexão; finalizar a chamada quando o agente sai; cor da imagem personalizada; valores de timeout
* Correções: **StepData screensharing**, dismiss, tracking de sucesso falso
* **2.2.0**: **Core v2.2.0**; **extensionName → extensionIdentifier** (breaking); eventos hangout
* Correções: switch, crash de diagnósticos, timer de timeout, **disableAudio()**

#### Versão: 2.1.X

**Agosto de 2024 / Setembro de 2024 / Outubro de 2024**

#### Geral

* Personalização da interface **Fluxo** (SDK Core)
* Adicionado **Selphix Step** (SDK Main)

#### Licensing

* Adaptado a **Core v2.1.X**

#### Tracking - Conexão com a plataforma

* **sdkVersion** em **initOperation**; constantes **2.1.1**; **Core v2.1.X**
* Retry em **sendEvents()**; timestamp **AssetResponse Int/String**; **apiKey** em **TrackingLicense** e **Api.shared**
* Headers HTTP; removido **token** (**Api.shared**); detalhes **PayloadModel**
* Correções: parsing, recursão **ITrackingController**, race condition, **libraryPackageVersion**, conflitos de merge

#### Selphi - Captura Facial

* **CommonCustomization**; **SelphiTheme**; tutorial e dicas; **LivenessDiagnostic** em **SelphiResult**
* **Core v2.1.X**; i18n para Core; **RawTemplate tokenizeController**
* Correções: hierarquia de diagnóstico, race **SignatureProof**, compilação, Lotties, acessibilidade, **MOVE (PR #54)**

#### SelphID - Captura de Documento

* **SelphID 1.26.X**; **SelphIDRGLComponent** via Pods; **CommonCustomization**
* Animação health e acessibilidade; **Widget v1.25.1**, constantes **v2.0.10**
* **Core v2.1.X**; **SignatureProof**; **Main Thread** para Widget; dica do tutorial anterior
* Correções: **diagnosticViewController**, captura, compilação, nomes Lottie, **Liveness MOVE**

#### Tokenizar

* Adaptado a **Core v2.1.X**; implementações movidas para extensão **Interface** para modularidade

#### Phingers - Captura de Impressão Digital

* **Core v2.1.X**; cores personalizadas, animações, labels de acessibilidade; área de vídeo expandida; paleta neutra
* Correções: casing da localização, race de chained tracking, nome da animação e gestão de permissões

#### VoiceId - Captura de voz

* **Core v2.1.X**; chained tracking; **showTutorial = true** por padrão; paleta neutra e constantes
* Novos Lotties, labels de acessibilidade, tags; mínimo iOS **11 → 13**; cor e tint dos ícones
* **enableCheckQuality**; frases no ambiente; código duplicado removido; métodos do Core; acessibilidade
* Correções: permissões e reprodução de áudio; **UIView\.fromNib** em main thread

#### Chamada de vídeo

* **CommonCustomization** e **themeFlow**; screen sharing e controle **shareScreen**
* Lotties personalizadas, personalização de cor, tint dos ícones; timeout de chamadas longas; **Core v2.1.X**
* Correções: tela de permissões, prevenção de landscape, switch cases, unwrap de views, **Package.swift** e template

#### VideoID - Identificação por vídeo

* **Core v2.1.X**; cores personalizadas, animações, labels de acessibilidade; área de vídeo expandida; paleta neutra
* Correções: casing da localização, race de chained tracking, nome da animação e gestão de permissões

#### Gravação de vídeo

* **Core v2.1.X**; **CommonCustomization**; **SdkResult** em success; extensões removidas **String**
* Correção: o broadcast não iniciava; parar a gravação fora do lifecycle do app

***

#### Versão: 2.0.X

**Abril de 2025 / Maio de 2024 / Junho de 2024**

#### Geral

* **FPHISDKLicenseCheckerComponent 2.0.0**; diagnóstico **IStatusController** e tutorial (SDK Core)
* Refatoração **launchDiagnostic(...)**; **launchTutorial()** (SDK Core)
* Atualizações **ErrorType**; **NO\_DATA\_ERROR**; **LICENSE\_CHECKER\_ERROR(String)**; **MISSING\_COMPONENT\_LICENSE\_DATA** (SDK Core)
* Adaptado a **Core v2.0.0** (SDK Main)

#### Licensing

* Dependências e constantes alinhadas com **Core v2.0.0**

#### Tracking - Conexão com a plataforma

* **Privacy Manifest** e campos de privacidade; localização **privacyInfo**; **Core v2.0.0**; bundle **.xcprivacy**
* Check SIM condicional — **nil** em iOS **16+**

#### Selphi - Captura Facial

* **bestImageTokenized**; retry no timeout; **logImages**; **Core v2.0.0**; **Privacy Manifest**
* Validação de licença e propagação de erros
* Correção do nome do step **SIGNATURE\_SELPHI\_CONTROLLER → SIGNATURE\_SELPHI\_COMPONENT**
* Callbacks de licença; **TrackAssetType.SELPHI\_SIGNATURE**

#### SelphID - Captura de Documento

* **SelphIDWidget v1.24.3 – v1.25.0**; retry no timeout; acessibilidade front/back após timeout
* Constantes **v2.0.6**; **DocumentReader v7.1.X**; **Privacy Manifest**; **FPhiSelphIDWidgetiOSSim v1.23.3**
* Correções: permissões, **selphidwidgetiosSim → selphidwidgetios**, **defaultLocalization**, frequência do tutorial, mensagem instrucional

#### Tokenizar

* **FPBTokenizer v2.0.8**; **bestImageTokenized**; dependências e **Core v2.0.0**

#### Phingers - Captura de Impressão Digital

* Widget e constantes **v2.0.0**; **Privacy Manifest** e **.xcprivacy**; **Core v2.0.0**, **Streaming de Vídeo v4.3.0**, **Lottie v4.4.0**
* Gestão de erros (vídeo e documento em logs); retry no timeout
* Correções: race na biblioteca de **streaming de vídeo**, vídeo em branco e sequência do step flow, init background thread, UX (assinatura, dark mode, permissões)

#### VoiceId - Captura de voz

* **Privacy Manifest**; **Core v2.0.0**; constantes; **streaming de vídeo a versão 4.3.0** e **Lottie 4.4.0**
* **VoiceEnrollmentResult**
* Correções: timing de exibição da frase, retry do timeout, callback e stop recording, localização **informações de privacidade**

#### Chamada de vídeo

* **Privacy Manifest** e localização; **Core v2.0.0**; constantes **v2.0.0**
* Bundle **.xcprivacy**; **streaming de vídeo a v4.3.0**, **Lottie v4.4.0**
* Correções: **appId** a partir da resposta do socket; ícone da seta de fechar desatualizado

#### VideoID - Identificação por vídeo

* Widget e constantes **v2.0.0**; **Privacy Manifest** e **.xcprivacy**
* **Core v2.0.0**, **streaming de vídeo a v4.3.0**, **Lottie v4.4.0**
* Gestão de erros (vídeo e documento em logs); retry timeout
* Correções: race na biblioteca de **streaming de vídeo**, vídeo em branco e sequência do step flow, init background thread, UX (assinatura, dark mode, permissões)

#### Gravação de vídeo

* **streaming de vídeo** e constantes; **Privacy Manifest** e **.xcprivacy**
* **Core v2.0.0** e **streaming de vídeo em v4.3.0**
* **UserDefaults reason** em **PrivacyInfo**
* Dependências menores
* Correção de erros da sessão de gravação; upgrade de **streaming de vídeo** temporariamente **v4.3.0** até **v4.3.1**

***

#### Versão: 1.5.X

**Março de 2024 / Abril de 2024**

#### Geral

* Tutorial **Status**; gestão de erros (SDK Core)
* Novos eventos e **getExtraParams()**; **signatureProofEvent**; **checkPermissionStatus**; hápticos (SDK Core)
* **IStatusableController**, **IFlowController**, **IFlowableController**; **SdkColor**; **ICustomizableController** (SDK Core)
* **retryAction → secondaryAction**; removido **PersonalData**
* **IMethodableController** estende **ITokenizableController**
* **startNextController SdkResult**; **dataString** em **IConfigurableController**
* **Core 1.5.8**; **Flow v2**; **FlowController**; gestão de erros (SDK Main)
* **FlowConfigurationData**; **SdkFlowResult**; **cancelFlow()**; **IStatusController**
* **GetModels IA\_OCR**, **iaModels**; **GetFlowConfiguration**, **GetFlowPreviewConfiguration**
* **ExternalStepController**
* **onlineFlow**; **FlowController.controllers**; **flowOutput unificado**
* Removido **newOperation** de **FlowConfigurationData**
* **activateFlow**; **launchNextStep público**
* **cancelFlow automático**
* **enableTracking**
* IDs e targets
* Personalização
* Correções: **LICENSE\_CHECKER\_ERROR initSdk**, **flowOutput n+1**, ordem dos steps

#### Licensing

* **Core v1.5.6**
* Referências **Core v1.5.0**
* Gestão de erros

#### Tracking - Conexão com a plataforma

* **Core v1.5.8**
* Arquitetura de tracking e eventos do flow
* **Core v1.5.0**
* Novos eventos da plataforma
* **osName "iOS"**
* Parâmetros **Payload**
* **signatureProofEvent**
* Removido **PersonalData**
* Correção do evento de assinatura, **OCR\_DATA**, **newOperation setupToken**

#### Selphi - Captura Facial

* **SignatureSelphi** estende controller principal
* **Core v1.5.8**
* Flow e eventos
* **SignatureSelphiController**
* Eventos da plataforma
* **vibrationEnabled**
* Hápticos
* **SelphiConfigurationData** a partir de JSON
* Inicializador **RawTemplateController Data**
* **SelphiFaceLivenessMode.MOVE**
* **extractionTimeout min/max**
* Padrões: **showTutorial**, **showDiagnostic**, **showResultAfterCapture**, **debug**
* Sem fallback ZIP por padrão
* Correção da inicialização **RawTemplateController**

#### SelphID - Captura de Documento

* **Core v1.5.8**
* **FPhiSelphIDWidgetiOSSim**
* **arm64** e **arm64-simulator**
* Novos eventos da plataforma
* **extractionTimeout min/max**
* Sem ZIP por padrão
* **Widget 1.23.2**
* Correção **CANCEL\_BY\_USER** com **showDiagnostic == true**

#### Tokenizar

* **Core v1.5.8**
* Compatibilidade **Core v1.5.6**
* Referências **Core v1.5.0**
* Gestão de erros

#### Phingers - Captura de Impressão Digital

* **SignatureVideoId** e gestão de erros de rede
* **HapticNotification** e vibração
* **Starscream** e constantes
* **Core v1.5.6** e configurações
* Core e constantes
* Telas de diagnóstico e configuração do flow
* Barra de progresso por step
* Inicialização da configuração baseada em JSON
* Correções: tracking do step naming, URL/API/Tenant nulo ou vazio, timeout e reinício da assinatura, literais e payload

#### VoiceId - Captura de voz

* Mudanças funcionais e de UI maiores
* **Core v1.5.8**
* Interação do usuário e feedback
* Controller estende **IFlowableController**
* **IStatusController**
* **showDiagnostic**
* **vibrationEnabled**
* **FPHIVoiceSDK v3.13.0**
* Eventos da plataforma
* Timeout **60000 → 30000 ms**
* Hápticos
* **RecorderView**
* **startRecording viewDidLoad**
* **extractionTimeout min/max**
* Sistema de gestão de erros

#### Chamada de vídeo

* **1.5.9**: **Core v1.5.8**; permissões da câmera e diagnóstico; estabilidade e controle do flow; eventos da plataforma; **IStatusController**; hápticos e **vibrationEnabled**; diagnóstico e permissões via **StatusController**; validação de rede; **extractionTimeout**; correções URL/apiKey/tenantId nulo
* **1.5.0**: controller estende **IFlowableController**; sistema de gestão de erros

#### VideoID - Identificação por vídeo

* **SignatureVideoId** e gestão de erros de rede
* **HapticNotification** e vibração
* **Starscream** e constantes
* **Core v1.5.6** e configurações
* Core e constantes
* Telas de diagnóstico e configuração do flow
* Barra de progresso por step
* Inicialização da configuração baseada em JSON
* Correções: tracking do step naming, URL/API/Tenant nulo ou vazio, timeout e reinício da assinatura, literais e payload

#### Gravação de vídeo

* **Starscream 4.0.8**
* **Core v1.5.4**, **v1.5.6**, **v1.5.8**
* Estabilidade e flow
* Novos eventos da plataforma: **VideoRecordingComponent**