Pular para o conteúdo principal

Instalação

Instalando o pacote​

1. Configurando o registro npm​

Crie um arquivo .npmrc na raiz do seu projeto:

@qitech:registry=https://registry.npmjs.org/
//registry.npmjs.org/:_authToken=NPM_TOKEN_SENT_BY_QI_TECH

Substitua NPM_TOKEN_SENT_BY_QI_TECH pelo token fornecido pelo suporte. Caso ainda não tenha recebido o seu token, entre em contato com o suporte.caas@qitech.com.br.

2. Instalando a dependência​

yarn add @qitech/react-native-caas

3. Importação​

import {
  CAAS_ENVIRONMENT,
  CAAS_FONT_FAMILY,
  CAAS_LOG_LEVEL,
  FACE_RECON_AUDIO_CONFIGURATION,
  FACE_RECON_ERROR,
  startFaceRecon,
} from '@qitech/react-native-caas';

Configuração do Android​

1. Repositório Maven da QI Tech​

Adicione o repositório Maven da QI Tech ao build.gradle do projeto:

allprojects {
  repositories {
    maven { url 'https://sdks.qitech.com.br/' }
    ...
  }
}

2. AdMob​

Inicialize o serviço de AdMob adicionando o seguinte código ao AndroidManifest.xml:

<meta-data
  android:name="com.google.android.gms.ads.APPLICATION_ID"
  android:value="<ADMOB_APP_ID>"/>

Caso não possua um ADMOB_APP_ID, entre em contato com o suporte.caas@qitech.com.br.

Configuração do iOS​

1. Permissão de câmera​

Adicione a entrada NSCameraUsageDescription ao Info.plist do seu aplicativo, com o motivo pelo qual o app precisa de acesso à câmera:

<key>NSCameraUsageDescription</key>
<string>Precisamos da câmera para capturar a sua selfie</string>

2. Source do repositório iOS da QI Tech​

Adicione as seguintes sources no topo do seu Podfile:

source 'https://cdn.cocoapods.org/'
source 'https://github.com/QITechSDKs/iOS.git'

3. Frameworks estáticos​

Necessário apenas se você utiliza o Xcode anterior à versão 26:

use_frameworks! :linkage => :static
Atenção

O Flipper não funciona com use_frameworks!. Remova a chamada use_flipper() do seu Podfile caso ela esteja presente.

4. Estabilidade de módulo​

As dependências do Datadog exigem que o BUILD_LIBRARY_FOR_DISTRIBUTION esteja habilitado. Adicione o post_install abaixo (ou incorpore ao seu post_install existente):

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if ['DatadogCore', 'DatadogInternal', 'DatadogCrashReporting', 'DatadogLogs'].include?(target.name)
      target.build_configurations.each do |config|
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.5'
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
    end
  end
end

5. Instalação dos pods​

cd ios && pod install
Atenção

Se o seu aplicativo já utiliza Datadog, use a versão mais recente dentro do major 3.x. Se utiliza o FaceDetection do MLKit, use a versão mais recente dentro do major 8.x.

Configuração do Expo​

O pacote inclui um config plugin do Expo que aplica automaticamente todas as configurações nativas de iOS e Android descritas acima. No seu app.json:

{
  "expo": {
    "plugins": ["@qitech/react-native-caas"]
  }
}

Em seguida, execute o prebuild para aplicar as alterações nativas:

npx expo prebuild