> 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

Aqui você encontrará o histórico de versões e atualizações do SDK da Facephi para iOS. Recomenda-se manter sempre sua integração atualizada para a versão estável mais recente.

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

***

### Versão mais recente

**Versão:** 2.11.0\
**Setembro de 2026**

#### Geral

* Atualizada a versão menor do **core para 2.11.0** e publicação alinhada de componentes nativos em **2.11.0**.

#### Selphi - Captura Facial

* Atualizada a dependência do widget **Selphi**; nova versão do widget: **6.4.0**.
* Plataforma mínima do pacote SPM: **iOS 13**.

#### SelphID - Captura de Documento

* Novo parâmetro de entrada *encodedDataFocusEnabled* que ativa o modo de leitura de códigos de barras quando há dificuldade de leitura (somente ativo no flavor MBSDR e com zip de recursos de uma versão > 1.41.4).
* Novos parâmetros de saída *encodedDataImages* e *tokenEncodedDataImages* com os resultados de uma leitura de códigos de barras (somente ativo no flavor MBSDR e com zip de recursos de uma versão > 1.41.4).

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

* Atualizado **FPHISelphidDocumentReaderBundle** para **3.3.8**.

#### Capture - Upload de arquivos / captura

* **Mudança incompatível:** FileUploader, QR Reader e QR Generator passam a **FPHICaptureWidget** (KMP). A UI nativa (Invoice, galeria e QR próprios) é removida. Widget **1.4.3**.

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

* Atualizada a dependência do widget **Phingers**; nova versão do widget: **1.5.5**.

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

* Atualizada a dependência do widget **Tracking** para **1.4.9**.

#### NFC 2.19.0 - Leitura de documento NFC

* Atualizada a dependência de **Core** para **2.11.0**.
* **Correção:** o indicador de progresso da sessão NFC mostra **6 pontos** em uma linha separada abaixo da descrição.

***

### Versões anteriores

#### Versão: 2.10.0

**Julho de 2026**

#### Geral

* Novas cores para a personalização.

#### Termos e condições de uso

* Criação do novo componente.
* **Mudança incompatível / migração:** o componente **Disclaimer** passa a se chamar **TermsConditions**. Atualizar referências de integração de `FPHISDKDisclaimerComponent`, `DisclaimerController`, `DisclaimerConfigurationData`, `DisclaimerResult` e temas `ThemeDisclaimer*` para seus equivalentes `FPHISDKTermsConditionsComponent`, `TermsConditionsController`, `TermsConditionsConfigurationData`, `TermsConditionsResult` e `ThemeTermsConditions*`.

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

* Eventos para os termos e condições de uso.

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

* Melhorias na interface e na experiência do usuário.
* Melhorias no processo de captura.
* Melhorias no processo de captura com pouca iluminação.
* Melhorias no foco da imagem em diferentes dispositivos.
* **Mudança incompatível / migração (literais):** as chaves de personalização de textos deixam de usar o prefixo `phingers_tf_component_*` e passam a `phingers_widget_*`.

#### Upload de arquivos e gerenciamento de QR - Capture

* **Mudança incompatível / migração (literais):** as chaves de personalização de textos são alinhadas com Android. Desaparecem chaves específicas de iOS como `capture_component_invoice_*` e passam a ser usadas `capture_component_*` e `capture_widget_*`.

#### Captura de Documentos - SelphID

* **Correção:** correção do problema de layout no estado **CaptureBackError**.
* **Correção:** correção de imagens cortadas em **RGL**. Agora os componentes vermelho e azul estão corretos.
* **Correção:** corrigida a orientação do reconhecedor `DocumentDetector` nos flavors **ML** e **MBSDR**.

#### Captura Facial com IAD - Selphi

* **Correção:** removido o zoom indesejado da câmera no flavor **IAD**.
* **Correção:** corrigida a estabilização com `LivenessMode = NONE`. A estabilização deixa de ser obrigatória neste modo.

***

### Versões anteriores

#### Versão: 2.8.1

**Junho de 2026**

#### Geral

* Release parcial de componentes com atualizações necessárias.

#### 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** para **0.9** em ambos os parâmetros.
* **Mudança incompatível (comportamento):** **`enableFlash`** pode ser ativado mesmo estando 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 final do processo.

#### Selphi - Captura Facial

* Novo parâmetro **`animateDismiss`** em **`SelphiConfigurationData`**: indica se o fechamento do SDK é animado ao final do 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 app 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

* Atualizada a versão menor do **core para 2.8.0** e publicação alinhada de componentes em **2.8.0** onde se aplica.
* **Mudança incompatível (personalização de recursos):** a chave da cor de fundo do SDK passa de `sdkBackgroundColor` para **`sdkBackgroundPrimaryColor`**; é preciso atualizá-la ou o tema não aplicará o fundo esperado. Também é adicionado **`sdkBackgroundSecondaryColor`** (entre outros usos, na tela de 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:** é limpa a cache de personalização do **Flow** ao inicializar o controller (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:** é limpa a cache de personalização do **Flow** ao inicializar o controller (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 pela 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 conforme o modo de captura por dedo.

#### NFC 2.16.0 - Leitura de documento NFC

* **Recurso:** suporte a imagens no formato **JPEG2000** em **DG2** e **DG7**.
* **Correção:** a UI de **tutorial** respeita a flag **`showTutorial`** (deixava de ser aplicada ao estar forçada a `true`).
* **Diagnóstico:** ampliação de **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 incompatíveis 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 incompatíveis 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:** é preservado o **progresso da captura facial** ao mudar de modo (por exemplo, apenas rosto frontal para fluxos mistos).
* Atualizado e adaptado **FPHISelphidDocumentReaderBundle** para **2.1.0**.

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

* **Mudança incompatível:** dependência de **streaming de vídeo** atualizada por mudanças incompatíveis 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 com 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**, dependendo do deployment.
* Novos metadados no envio de eventos de tracking: **versão do SDK** em *tags* e **`operationId`** em **LinkedId** onde se aplica.

#### Status

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

***

#### Versão: 2.7.X

**Março de 2026**

#### Geral

* Atualizada a versão menor do core 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.
* Melhorada a gestão de erros de rede e o feedback para o app do integrador.

#### Selphi - Captura Facial

* Envio do identificador do 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

* Recurso: adicionado seletor de documento e país. Esse seletor é uma view de 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

* Atualizada a versão menor do core 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** para **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 **start**
* 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 o recurso **DEMOS** não suportava a injeção de **integrationId** em VideoRecording
* Corrigido problema pelo qual VideoRecording era interrompido 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)
* Atualizada a versão menor do core 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
* Atualizada a versão menor do core para 2.5.0
* Adicionado suporte para **IDV Proxy**
* Adicionado suporte para o step de **NFC** em IDV
* Corrigido o parâmetro **etapas** 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

* Atualizada a versão menor do Core 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
* Atualizada a versão menor do core para 2.5.0
* Adicionados parâmetros capturados ao Fluxo para usá-los como entrada do leitor NFC de documentos

#### Tokenize

* Atualizada a versão menor do core para 2.5.0

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

* Atualizada a versão menor do core para 2.5.0
* Atualizada a versão maior de **SelphID Leitor de Documentos (SDR)** para 2.0.0
* Refatorado **ErrorType.TIMEOUT** para **ErrorType.SDK\_TIMEOUT**
* Novos modos (**VideoIdMode.DOCUMENT\_FRONT** e **VideoIdMode.DOCUMENT\_FRONT\_BACK**) para captura apenas de documento

#### VoiceId - Captura de voz

* Atualizada a versão menor do core para 2.5.0
* Refatorado **ErrorType.TIMEOUT** para **ErrorType.SDK\_TIMEOUT**

#### Chamada de vídeo

* Atualizada a versão menor do core para 2.5.0
* Refatorado **ErrorType.TIMEOUT** para **ErrorType.SDK\_TIMEOUT**
* Corrigido evento de Tracking duplicado ao iniciar o diagnóstico

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

* Atualizada a versão menor do core para 2.5.0
* Atualizada a versão maior de **SelphID Leitor de Documentos (SDR)** para 2.0.0
* Refatorado **ErrorType.TIMEOUT** para **ErrorType.SDK\_TIMEOUT**
* Novos modos (**VideoIdMode.DOCUMENT\_FRONT** e **VideoIdMode.DOCUMENT\_FRONT\_BACK**) para captura apenas de documento

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

* Atualizada a versão menor do core para 2.5.0
* Refatorado **ErrorType.TIMEOUT** para **ErrorType.SDK\_TIMEOUT**
* Adicionado timestamp na parte inferior das gravações de vídeo
* Corrigido para 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**; refatorizado **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; eliminados **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)
* Eliminados **activateFlow** e **iaModels** de **initSdk()**; **FlowData IDs** e **operationType** públicos (SDK Main)
* Refatorados **SDKController** e **Flow**; **IdvLicense**; **LicensingComponent** interno (SDK Main)
* Novo método público de Personalização; correções para **operationId**, **customization.colors**, **verificação de licenciamento**, **referência da etapa** (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; eliminado **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**

#### Tokenize

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

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

* Atualizado e adaptado ao último **trackingWidget**; **SDR v1.8.0**; **trackAssets** para IDV
* **sendVideoIdData**; renomeado **matchingSidesScore**; eliminado **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 no Matching local); primeira versão **v2.4.0**
* Revisão de 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 de UX para animações, literais e Fluxo
* 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**; eliminado **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 caso de borda com instância ativa

***

#### Versão: 2.3.X

**Junho de 2025 / Julho de 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)
* Corrigir 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 no SDK; idioma 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 Fluxo, **ColorFlowKeys**, **PR #90** (SDK Main)

#### Licenciamento

* 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, background-thread, incompatibilidade 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; idioma a partir de **initSdk()**; Tracking de eventos 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

#### Tokenize

* **Core v2.3.2, v2.3.1, v2.3.0**
* Adicionada validação de dados vazios antes de enviá-los para **Core Tokenizer** para prevenir 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 mudança 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, background thread, memory leaks, capturas, literais, **AnalyticsManager → IAnalyticsController**

#### VoiceId - Captura de voz

* **Core v2.3.2**; **UIFontMetrics** para escalonamento dinâmico de texto; analytics e eventos de Tracking
* **Core v2.3.0**; corrigir Lottie; logging do componente; **SDK de Vozes**; unificado com Android
* Controle prévio de dicas e feedback háptico; fix **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 de screen sharing; fix mute during screen sharing
* **2.3.3**: **Core v2.3.2**
* **2.3.2**: **UIFontMetrics**; fix **hasOperationCreated** e **fromNib na thread principal**; **AnalyticsManager → IAnalyticsController**
* **2.3.0**: analytics no SDK; **Core v2.3.0**; unificado com Android; Catalão e Português; language desde **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 mudança 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, background thread, memory leaks, capturas, literais, **AnalyticsManager → IAnalyticsController**

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

* Timestamp nos metadados de gravação; **Core v2.3.2**; serviço **stopCapture**
* Referência eliminada **Resources** e extensão de screen recording; **Core v2.3.1**
* Eventos: **COMPONENT\_START**, **STOP**, modal de permissão de screen sharing; **Core v2.3.0**
* Corrigir 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)
* Corrigir **Test.podspec 2.2.1**, **UIColor(hex:)**; limpeza da interface **Status** (SDK Core)
* Personalização da interface Flow (SDK Core 2.1); fix **IDiagnosticView Main Thread** (SDK Core 2.1)
* Atualizado **Core v2.2.2**; licenciamento; **PR #89**; **Tracking StepData screen sharing** (SDK Main)
* Removido **prévia do flow**; **json → jsonX**; corrigir persistência da configuração do flow; manifest **Package-template** (SDK Main)
* **fix\_customization\_flow**; reverter mudanças incorretas; lógica eliminada **prévia do flow**

#### Licenciamento

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

#### 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 de Widget; **Core v2.2.0**
* **TrackingControllerKMP**; widget KMP; **trackingWidget v1.0.1**; **LocationManager**
* Refatoração **TrackingError**; workaround do Core antigo
* Correções: crash **advanceTracking()**, **setTrackingError before start()**, compilação, race condition, **tenantId privado**

#### Selphi - Captura Facial

* Idioma padrão = dispositivo; flash da câmera traseira; **Core (SM-4399)**; **Widget v5.16.3**
* **modo MOVE da câmera traseira**; **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: iniciar thread em segundo plano, navegação, crashes na 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 screen sharing**, **Widget v1.28.2**

#### Tokenize

* Versão mais recente **FPBTokenizer**; compatibilidade com Core; dependência Tokenizer e breaking changes; **Core v2.2.0**
* Corrigir erro **Tracking StepData** durante screen sharing

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

* **autoFaceDetection** e botão da câmera; seleção de câmera e fontes custom; progress bar e UX
* Dark Mode; navegação de diagnósticos; refatoração **VideoIdSteps**
* Timeout e imagem de cor custom; 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 UI, conflitos Core, **successResponse**, literais de detecção facial e assinatura

#### VoiceId - Captura de voz

* Core atualizado; suporte a cor do Dark Mode; parâmetro **minSpeechLength**
* Logs e checagens do microfone; warning **MultipleSpeakers** se **enableQualityCheck = false**
* **SDK de Voz v4.1.0**; animações custom; refatoração do tutorial (flow baseado em estado)
* Timeouts e dismiss somente em **retryAction**
* Correções: navegação **TIMEOUT**, cancelar/reiniciar gravação, **StepData screen sharing**, **VoiceEnvironment**, **PrivacyInfo.xcprivacy**

#### Chamada de vídeo

* **2.2.5**: Core latest; fontes custom 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 call quando o agente sai; cor da imagem custom; valores de timeout
* Correções: **StepData screen sharing**, dismiss, false success tracking
* **2.2.0**: **Core v2.2.0**; **extensionName → extensionIdentifier** (breaking); eventos de hangout
* Correções switch, crash de diagnósticos, timer de timeout, **disableAudio()**

#### Versão: 2.1.X

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

#### Geral

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

#### Licenciamento

* 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 no 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**; **thread principal** para Widget; dica prévia do tutorial
* Correções: **diagnosticViewController**, captura, compilação, nomes Lottie, **Liveness MOVE**

#### Tokenize

* 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 custom, animações, labels de acessibilidade; área de vídeo expandida; paleta neutra
* Correções: casing de localização, race 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; iOS mínimo **11 → 13**; cor e tint dos ícones
* **enableCheckQuality**; frases no ambiente; código duplicado removido; métodos Core; acessibilidade
* Correções: permissões e reprodução de áudio; **UIView\.fromNib** na thread principal

#### Chamada de vídeo

* **CommonCustomization** e **themeFlow**; screen sharing e controle **shareScreen**
* Lotties custom, 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 custom, animações, labels de acessibilidade; área de vídeo expandida; paleta neutra
* Correções: casing de localização, race 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; stop recording fora do lifecycle da app

***

#### Versão: 2.0.X

**Abril 2025 / Maio 2024 / Junho 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)

#### Licenciamento

* 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**
* Verificação SIM condicional — **nil** no iOS **16+**

#### Selphi - Captura Facial

* **bestImageTokenized**; retry em timeout; **logImages**; **Core v2.0.0**; **Privacy Manifest**
* Validação de licença e propagação de erros
* Corrigir 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 em 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

#### Tokenize

* **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 nos logs); retry em timeout
* Correções: race na biblioteca de **streaming de vídeo**, vídeo em branco e sequência step flow, init de thread em segundo plano, UX (assinatura, dark mode, permissões)

#### VoiceId - Captura de voz

* **Privacy Manifest**; **Core v2.0.0**; constantes; **streaming de vídeo para a versão 4.3.0** e **Lottie 4.4.0**
* **VoiceEnrollmentResult**
* Correções: timing de exibição da frase, retry 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 para v4.3.0**, **Lottie v4.4.0**
* Correções: **appId** a partir da resposta do socket; ícone de seta de fechamento 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 para v4.3.0**, **Lottie v4.4.0**
* Gestão de erros (vídeo e documento nos logs); retry timeout
* Correções: race na biblioteca de **streaming de vídeo**, vídeo em branco e sequência step flow, init de thread em segundo plano, 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 na v4.3.0**
* **UserDefaults reason** em **PrivacyInfo**
* Dependências menores
* Corrigir 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 2024 / Abril 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**; eliminado **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 alvos
* Personalização
* Correções: **LICENSE\_CHECKER\_ERROR initSdk**, **flowOutput n+1**, ordem dos steps

#### Licenciamento

* **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 de 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 o controller principal
* **Core v1.5.8**
* Flow e eventos
* **SignatureSelphiController**
* Eventos da plataforma
* **vibrationEnabled**
* Hápticos
* **SelphiConfigurationData** a partir de JSON
* Inicializador **Dados do RawTemplateController**
* **SelphiFaceLivenessMode.MOVE**
* **extractionTimeout min/max**
* Padrões: **showTutorial**, **showDiagnostic**, **showResultAfterCapture**, **Debug**
* Sem fallback ZIP 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 padrão
* **Widget 1.23.2**
* Corrigir **CANCEL\_BY\_USER** com **showDiagnostic == true**

#### Tokenize

* **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 de Flow
* Barra de progresso por etapa
* Inicialização de configuração baseada em JSON
* Correções: nomenclatura do Tracking de etapa, URL/API/Tenant nulo ou vazio, Timeout e reinício da assinatura, literais e payload

#### VoiceId - Captura de voz

* Grandes mudanças funcionais e de UI
* **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 de câmera e diagnóstico; estabilidade e fluxo de controle; eventos da plataforma; **IStatusController**; hápticos e **vibrationEnabled**; diagnóstico e permissões via **StatusController**; validação de rede; **extractionTimeout**; correções de 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 de Flow
* Barra de progresso por etapa
* Inicialização de configuração baseada em JSON
* Correções: nomenclatura do Tracking de etapa, 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 fluxo
* Novos eventos da plataforma: **VideoRecordingComponent**