Instalação e Configuração

Este tutorial orienta você no processo de integração da biblioteca PeripheralsLib ao seu projeto do Android Studio. Você aprenderá como importar o arquivo da biblioteca, configurar as dependências de compilação e atualizar o manifest do seu aplicativo para oferecer suporte ao Android 12 e superior.

Pré-requisitos

• Um projeto existente no Android Studio.
• O arquivo peripheralslib.jar fornecido com o pacote de integração.

Passo 1: Importar a biblioteca

1. Abra o seu projeto no Android Studio.
2. Navegue até a visualização Project (não a visualização Android) no “Project Explorer”.
3. Localize o módulo do seu aplicativo (geralmente chamado de app).
4. Expanda o módulo e procure por uma pasta chamada libs.
   • Se a pasta não existir, clique com o botão direito na pasta app, selecione New > Directory e nomeie-a como libs.
5. Copie o arquivo peripheralslib.jar e cole-o no diretório libs.

Passo 2: Configurar dependências do Gradle

Para disponibilizar as classes da biblioteca para o seu código, você deve adicioná-la como uma dependência na sua configuração de compilação.

1. Abra o arquivo build.gradle do módulo do seu aplicativo (frequentemente rotulado como Module: app).

2. Localize o bloco dependencies.

3. Adicione a seguinte linha para incluir o arquivo JAR:

   implementation files('libs/peripheralslib.jar')

   ⧉

4. Sincronize seu projeto com os arquivos do Gradle.

Passo 3: Configurar o Android Manifest (Android 12+)

Dispositivos executando o Android 12 (nível da API 31) ou superior exigem permissões específicas para interagir com os serviços do sistema usados pela PeripheralsLib. Você deve declarar essas permissões no seu AndroidManifest.xml.

1. Abra app/src/main/AndroidManifest.xml.

2. Adicione a permissão QUERY_ALL_PACKAGES e o bloco <queries> necessário dentro da tag <manifest>, mas fora da tag <application>.

   <manifest xmlns:android="[http://schemas.android.com/apk/res/android](http://schemas.android.com/apk/res/android)"  
       xmlns:tools="[http://schemas.android.com/tools](http://schemas.android.com/tools)"  
       package="com.your.package">
   
       <uses-permission  
           android:name="android.permission.QUERY_ALL_PACKAGES"  
           tools:ignore="QueryAllPackagesPermission" />
   
       <queries>  
           <package android:name="com.redsys.t_android.appservice" />  
       </queries>
   
       <application ...>  
           ...  
       </application>
   
   </manifest>

   ⧉

Resumo

Você importou a biblioteca com sucesso e configurou as permissões necessárias. Seu projeto agora está pronto para instanciar o PeripheralsManager.