Readme.ptBR.md

Mobile Permissions

Este é um componente para facilitar a solicitação de permissão no Android 8.x ou posterior.

O componente MobilePermissions foi desenvolvido para facilitar a solicitação e concessão de permissão aos recursos do sistema operacional que o aplicativo necessita utilizar. Buscamos simplificar a vida do desenvolvedor Delphi Mobile.

Traduzimos todas as permissões previstas em Project > Options > Application > User Permissions para o componente, para que o desenvolvedor não precise entrar na janela de configurações do projeto para marcar as permissões que deseja solicitar, basta arrastar um componente MobilePermissions ao Form e marcar as propriedades que deseja usar.

💎 Categorias

O componente foi dividido em 03 (três) categorias distintas de permissões representadas por imóveis e subpropriedades. São eles:

• DANGEROUS: as permissões de uso a seguir exigem aprovação do usuário em tempo de execução.
• SIGNATURE: As seguintes permissões de uso exigem um certificado correspondente.
• STANDARD: Permissões de uso normal

😎 Facilidades

Ao usar o componente, o desenvolvedor não precisa mais acessar Project > Options > Application > User Permissions porque ao marcar/desmarcar a propriedade, o componente ajusta automaticamente as configurações do projeto.

Antes de instalar

Certifique-se de ter desinstalado todas as versões anteriores do componente antes de instalar uma nova.

Instalação por pacote

1. Abra o Delphi no modo de administrador. O Delphi precisa buildar e criar um .BPL nos diretórios do sistema.
2. Abra o arquivo do pacote MobilePermissions MobilePermissions.dpk.
3. Clique com o botão direito em MobilePermissions.bpl no Project Manager e selecione Clean.
4. Clique com o botão direito em MobilePermissions.bpl no Project Manager e selecione Build.
5. Clique com o botão direito em MobilePermissions.bpl no Project Manager e selecione Install.

Se o menu Instalar não for exibido no menu de contexto, selecione Windows 32 bits no Gerenciador de projetos e clique com o botão direito novamente.

Preparar! 😎

Instalação pelo Get It Package Manager?

1. Abra o Delphi no modo de administrador. O Delphi precisa construir e criar um .BPL nos diretórios do sistema.
2. Abra Ferramentas > Get It Packager Manager.
3. Digite MobilePermissions na caixa de pesquisa.
4. Ao encontrar o componente clique sobre ele e clique em Botão Install.

5. Aceite os termos e contrato clicando em Concordo com tudo e Avançar
6. Aguarde o processo de instalação

Pronto! 😎

⚡️ Início rápido

Modo 1

1. Solte um componente no formulário (Tool Pallete TDevRocks).
2. Selecione a permissão que deseja solicitar ao Android em seu projeto móvel.
3. Execute seu aplicativo no Android.

Modo 2

1. Crie um novo projeto.
2. Arraste os controles como abaixo.

• Arraste um TButtom para o formulário
• Arraste um TMobilePermissions para o formulário
• No evento OnCreate do tipo Form

3. Digite o código.

procedure TForm1.OnCreate(Sender: TObject);
begin
  MobilePermissions1.[CATEGORY].[Permission] := True;
  MobilePermissions1.Apply;
end;

Exemplo.:

procedure TForm1.Button1Click(Sender: TObject);
begin
  MobilePermissions1.Dangerous.CAMERA := True;
  MobilePermissions1.Standard.AccessNetworkState := True;
  MobilePermissions1.Apply;
end;

3. Execute seu aplicativo no Android.

⚠ Requisitos

Adicione este caminho de pasta no campo Caminho de pesquisa como abaixo:

\MobilePermissions\source<br>
\MobilePermissions\component<br><br>

Recompile e redistrconstrua seu projeto e voilà

🧪 Compatível com

Delphi 10.2+

🧪 Testes realizados em

Android 7.0 (Esta versão não precisa deste componente, mas você pode usar sem problemas)
Android 8.x
Android 9.x
Android10
Android11
Android 12
Android 13
Android 14

💻 Contribuidores de código

Idiomas da documentação

Inglês (en)
[Português (pt-BR)](Português (ptBR)
)

⚠️ Licença

MobilePermissions é uma biblioteca gratuita e de código aberto licenciada sob a Licença MIT.