# 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: 
   
   ```gradle
   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>`.  
   
   ```xml
   <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>
   ```

<Callout type="note">

O bloco `<queries>` garante que seu aplicativo possa detectar e se comunicar com o serviço subjacente (`com.redsys.t_android.appservice`) nas versões mais recentes do Android.

</Callout>

## Resumo

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