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-device-scan

3. Importação​

import {
  CAAS_ENVIRONMENT,
  startDeviceScan,
} from '@qitech/react-native-device-scan';

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.

3. Permissões​

Declare no AndroidManifest.xml as permissões que deseja disponibilizar ao SDK. Veja Permissões para a lista completa.

Configuração do iOS​

1. 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'

2. 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.

3. 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

4. Permissões​

Declare no Info.plist as permissões que deseja disponibilizar ao SDK. Veja Permissões.

5. Instalação dos pods​

cd ios && pod install

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-device-scan"]
  }
}

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

npx expo prebuild