Home - mrhenry549/Cripto-Escutas GitHub Wiki

Bem-vindo à wiki da aplicação de Códigos e Cifras!

logo

Manual de Instalação

Este manual de instalação tem por objetivo mostrar os procedimentos necessários para a instalação e execução da aplicação. Esta aplicação pode ser executada tanto num computador através de um emulador, como num dispositivo móvel.

Execução num emulador

Para executar a aplicação através de um emulador, este está hospedado no serviço do Appetize: Link para a emulação

ATENÇÃO!!! Este emulador não faz uma conversão precisa das mensagens, pelo que é recomendável instalar a aplicação num dispositivo ou numa máquina virtual para tirar maior partido da mesma.

appetize

Execução num dispositivo Android

Para fazer o download da aplicação, esta está disponibilizada na página de releases do GitHub da mesma.

releases

No processo de instalação da aplicação, é provável que o dispositivo onde estiver a correr o ficheiro lhe mostre uma mensagem para permitir a instalação de aplicações de fontes desconhecidas. Isto deve-se ao facto de não estar a instalar a aplicação a partir da Google Play Store e o sistema tenta prevenir esse mesmo ato. No entanto, é recomendado a permitir a instalação.

Manual de Utilizador

Este manual de utilizador tem por objetivo a introdução à aplicação. Para isso, a informação será organizada de forma a facilitar a utilização desta ferramenta. De seguida apresentamos a hierarquia dos menus e todas as suas funcionalidades, adotando uma sequência temporal, isto é, apresentamos cada parte do nosso programa pela ordem que será apresentada aquando da utilização do mesmo.

Ecrã inicial

Ao iniciar a aplicação, o utilizador é congratulado com o seguinte ecrã:

ecra inicial

Este ecrã tem como objetivo a apresentação das opções de encriptar ou desencriptar uma mensagem ao utilizador.

Ecrã de encriptação/desencriptação de mensagens

Ao clicar em uma das opções previamente descritas, o utilizador é congratulado com o seguinte ecrã que é semelhante entre a cifragem e a decifragem de uma mensagem:

Men1

Neste ecrã, o utilizador escolhe a cifra que quer utilizar, escrever a mensagem pretendida e, dependendo da cifra, escrever a palavra-chave.

Ao clicar na caixa de “Selecione uma cifra:”, a aplicação disponibiliza a lista de cifras implementadas na mesma.

Men2

Ao selecionar o campo “Mensagem”, a aplicação apresenta um cursor e teclado para que se possa escrever o texto que o utilizador pretenda cifrar.

Men3

No caso de estar a desencriptar uma mensagem usando uma cifra de símbolos, também irá aparecer um teclado próprio da aplicação que contém todas as letras do alfabeto convertidas em símbolos. Neste exemplo abaixo, é apresentado o teclado da cifra angular com todas as imagens por ordem alfabética.

Men4

Após ter selecionado a cifra pretendida, a aplicação poderá exibir um novo campo denominado “Password”. Este caso só acontece para um conjunto determinado de cifras. As cifras que apresentam este novo campo são:

  • Alfabeto Numeral;
  • Batalha Naval;
  • César;
  • Data;
  • Frase-Chave-Vertical;
  • Frase-Chave-Horizontal;
  • Horizontal;
  • Transposto;
  • Vertical.

Para adicionar uma password é necessário selecionar o campo “Password …”, sendo disponibilizado o teclado para o que possa fazer.

Men5

Após a execução dos passos anteriores, é possível selecionar o botão “Encriptar/Desencriptar”.

Ecrã de resultado

O Ecrã Resultado tem por objetivo primário a visualização da mensagem cifrada, tal com a partilha da mesma. Ao selecionar o botão “Encriptar/Desencriptar” é apresentado o ecrã abaixo, possibilitando assim o resultado da cifragem ou decifragem da mensagem.

Res1

Esta aplicação permite o envio das mensagens cifradas através de outras aplicações. As mensagens cifradas podem ser partilhadas ao carregar no botão “Partilhar”. Ao carregar nesse botão aparecerá um pedido por parte do sistema operativo para permitir a aplicação aceder à memória do dispositivo Android. Isto acontece porque é preciso guardar a imagem de resultado em memória antes de poder partilhar a mensagem.

Res2

Depois de o pedido ter sido aceite, aparecerá um menu de partilha que permite a escolha da aplicação pela qual pretende partilhar a mensagem ao carregar nesse botão outra vez.

Res3