As Shared Preferences são uma funcionalidade essencial no desenvolvimento de apps móveis que permite aos programadores guardar e obter pequenas quantidades de dados como pares chave-valor. O mecanismo é especialmente útil para guardar definições do utilizador, estados da app ou outros dados de configuração que têm de ser mantidos entre sessões da app. As Shared Preferences fazem parte da plataforma Android e oferecem uma forma simples e eficiente de tratar dados persistentes sem necessidade de configurações de bases de dados complexas.
Quando uma app utiliza Shared Preferences, os dados são guardados num ficheiro XML no armazenamento interno da app. Isto permite à app aceder e atualizar os dados rapidamente, o que melhora a experiência do utilizador ao manter as suas preferências e definições disponíveis e atualizadas. As Shared Preferences foram concebidas para serem leves e privadas da app, mas não são encriptadas, o que as torna uma escolha ideal para dados não sensíveis em apps otimizadas para desempenho e usabilidade.
As Shared Preferences são uma forma simples e eficiente de guardar pequenas quantidades de dados como pares chave-valor no armazenamento local do dispositivo, permitindo às aplicações móveis manter as definições do utilizador e os estados da aplicação entre sessões. Esta funcionalidade é ideal para guardar preferências do utilizador, como definições de tema ou se um utilizador tem sessão iniciada, pois oferece uma solução leve sem necessidade de uma base de dados. Os dados permanecem disponíveis para a aplicação mesmo depois de esta ser fechada ou reiniciada, o que garante uma experiência do utilizador consistente e personalizada. As Shared Preferences são especialmente úteis quando é necessário acesso rápido a dados persistentes e os requisitos de segurança são moderados, pois os dados não são encriptados por predefinição; palavras-passe e outros segredos não devem ser guardados nelas sem encriptação.
Mais sobre Shared Preferences
As Shared Preferences são uma tecnologia essencial no desenvolvimento de apps móveis que permite guardar de forma simples e eficiente pequenas quantidades de dados como pares chave-valor. O método é ideal para guardar definições do utilizador, preferências da aplicação e outros dados persistentes que têm de ser mantidos entre sessões da app. As Shared Preferences são particularmente adequadas para casos em que o acesso rápido aos dados e a facilidade de utilização são cruciais, como definições do utilizador, estado de sessão iniciada e configuração da app.
Tecnicamente, as Shared Preferences guardam os dados num ficheiro XML localizado no armazenamento interno da app. Quando uma app quer guardar ou obter dados, interage com este ficheiro através de uma API que trata das operações de leitura e escrita. Isto torna as Shared Preferences eficientes e fáceis de implementar, o que é uma grande vantagem para programadores que querem uma gestão de dados leve sem terem de tratar operações de base de dados complexas.
As Shared Preferences podem ser utilizadas em diferentes cenários, cada um apoiando um tipo diferente de tratamento de dados:
Guardar definições do utilizador: As Shared Preferences são utilizadas para guardar definições escolhidas pelo utilizador, como o tema, as preferências de notificações ou o idioma. Isto garante que as preferências do utilizador são mantidas mesmo quando a app é fechada e reaberta.
Gestão de sessões: As Shared Preferences podem ser utilizadas para guardar dados relacionados com a sessão, como o estado de sessão iniciada ou um ID de utilizador, o que permite à app lembrar-se do utilizador entre sessões sem repetidos inícios de sessão. Os tokens de acesso e outros segredos devem ser encriptados antes de serem guardados.
Dados de configuração: As aplicações podem guardar dados de configuração necessários para o funcionamento da app, como definições de funcionalidades ou valores predefinidos, o que facilita ajustar o comportamento da app sem alterar o código. As chaves de API secretas não pertencem às Shared Preferences, pois tudo o que é guardado no dispositivo pode ser extraído.
Um dos maiores pontos fortes das Shared Preferences é a sua simplicidade e eficiência. O acesso fácil aos dados através de pares chave-valor permite aos programadores implementar rapidamente armazenamento persistente de dados sem se preocuparem com operações de base de dados complexas. Os dados são também acessíveis apenas à app específica, o que proporciona um certo grau de segurança e privacidade.
O baixo consumo de recursos das Shared Preferences é outra vantagem importante. A tecnologia exige um espaço de armazenamento e uma capacidade de processamento mínimos, o que a torna ideal para dispositivos móveis em que a otimização de recursos é crítica. Como os dados são guardados no armazenamento interno da app, estão também normalmente protegidos contra o acesso de outras apps.
Na prática, as Shared Preferences foram durante muito tempo a forma padrão de guardar dados simples do utilizador em apps Android. São utilizadas para manter a experiência do utilizador consistente e personalizada, lembrando as preferências e o estado do utilizador. São também utilizadas para otimizar o desempenho da app, reduzindo a necessidade de pedidos de dados e chamadas de rede repetidos.
Em resumo, as Shared Preferences são uma tecnologia que combina simplicidade e eficiência numa solução que torna o armazenamento de dados mais intuitivo e acessível para os programadores. A capacidade de funcionar sem configuração complexa e com um consumo mínimo de recursos torna-as uma ferramenta importante no desenvolvimento de apps moderno, em que um tratamento de dados rápido e fiável é essencial.
Perguntas frequentes sobre Shared Preferences
O que são as Shared Preferences e como funcionam no desenvolvimento Android?
No desenvolvimento Android, as Shared Preferences são um mecanismo para guardar dados simples como pares chave-valor, que podem ser acedidos a partir de diferentes componentes de uma aplicação. O método é ideal para guardar pequenas quantidades de dados, como definições do utilizador ou configuração da aplicação, que não exigem uma base de dados.
Quando uma aplicação utiliza Shared Preferences, é criado um ficheiro com os dados guardados, e este ficheiro só é acessível à aplicação que o criou. Os dados são guardados num ficheiro XML no armazenamento interno da aplicação, o que os protege do acesso de outras apps num dispositivo normal, sem root. Os programadores podem ler e escrever facilmente neste ficheiro com métodos como getSharedPreferences(), edit(), putString() e commit() ou apply() para guardar as alterações.
Em comparação com soluções de armazenamento mais complexas, como as bases de dados SQLite, as Shared Preferences são muito mais simples e rápidas de implementar, especialmente quando só é preciso guardar dados simples que não exigem armazenamento estruturado nem consultas complexas. Isto faz das Shared Preferences uma escolha eficiente para muitas aplicações que precisam de guardar e obter pequenas quantidades de dados de forma rápida e fácil.
Como se guardam e obtêm dados com Shared Preferences?
Os dados são guardados nas Shared Preferences como pares chave-valor. Primeiro, obtém-se um objeto SharedPreferences, normalmente com getSharedPreferences e um nome de ficheiro. Para guardar dados, abre-se um editor com edit(), adicionam-se valores com métodos como putString ou putBoolean e as alterações são guardadas com apply(), que escreve de forma assíncrona, ou commit(), que escreve imediatamente.
Os dados são obtidos com métodos como getString ou getInt, indicando a chave e um valor predefinido que é utilizado se a chave não existir. Para projetos Android mais recentes, a Google recomenda muitas vezes o DataStore como substituto mais moderno, mas o princípio de chaves e valores é o mesmo.
Que tipos de dados podem ser guardados nas Shared Preferences?
As Shared Preferences suportam tipos de dados simples: cadeias de texto (String), números inteiros (int), inteiros longos (long), números decimais (float) e valores verdadeiro/falso (boolean). Pode também ser guardado um conjunto de cadeias de texto (Set de String).
Objetos mais complexos não podem ser guardados diretamente. Podem ser convertidos em texto, por exemplo em JSON, mas isso só é recomendado para pequenas quantidades de dados. As Shared Preferences destinam-se a informação leve, como definições do utilizador, um tema escolhido ou se uma introdução já foi mostrada. Dados maiores ou estruturados pertencem a uma base de dados como o Room ou a ficheiros.
Qual é a diferença entre as Shared Preferences e outros métodos de armazenamento, como o SQLite?
As Shared Preferences guardam pequenas quantidades de dados como pares chave-valor num ficheiro no dispositivo. São simples de utilizar, mas não são adequadas para quantidades de dados grandes ou complexas, e não é possível fazer consultas propriamente ditas.
O SQLite, muitas vezes através do Room, é uma base de dados relacional que consegue tratar grandes quantidades de dados estruturados, relações entre tabelas e pesquisas avançadas. Os ficheiros são adequados para imagens, documentos e outros dados maiores. O DataStore é a alternativa mais recente da Google às Shared Preferences, com acesso assíncrono. A escolha depende da quantidade de dados: definições nas Shared Preferences ou no DataStore, dados estruturados numa base de dados.
Como se protegem os dados guardados nas Shared Preferences?
Os dados nas Shared Preferences são guardados como texto simples na pasta privada da app. Normalmente, as outras apps não têm acesso, mas num dispositivo com root ou através de determinadas cópias de segurança o ficheiro pode ser lido. Palavras-passe, tokens e outra informação sensível não devem, por isso, ser guardados sem encriptação.
Os dados sensíveis podem ser encriptados antes de serem guardados, utilizando chaves mantidas na Android Keystore, concebida para proteger chaves criptográficas. A biblioteca Jetpack androidx.security:security-crypto oferecia anteriormente as EncryptedSharedPreferences para este fim, mas a Google marcou toda a biblioteca, incluindo EncryptedSharedPreferences, EncryptedFile e MasterKey, como obsoleta a partir da versão 1.1.0-alpha07, em abril de 2025. A recomendação da Google passa a ser utilizar as APIs normais da plataforma, como as SharedPreferences, em conjunto com a utilização direta da Android Keystore, em que se gera uma chave com o KeyGenerator e se utiliza para encriptar os valores antes de serem guardados. Em geral, deve guardar-se no dispositivo o mínimo possível de informação sensível.
Que limitações devem ser tidas em conta ao utilizar Shared Preferences?
As Shared Preferences destinam-se a pequenas quantidades de dados simples. Grandes quantidades de dados podem tornar a app mais lenta, porque o ficheiro inteiro é carregado em memória, e escrever com commit() na thread principal pode fazer a interface do utilizador engasgar-se.
Não existe suporte integrado para objetos complexos, relações ou consultas, e os dados não são encriptados automaticamente. Também não há segurança de tipos, pelo que uma chave ou um tipo de dados errado só é descoberto quando a app é executada. As alterações feitas a partir de vários processos ao mesmo tempo não são tratadas de forma fiável. Para necessidades mais avançadas, recomenda-se o DataStore, o Room ou armazenamento encriptado.
Shared Preferences para manequins
As Shared Preferences são uma funcionalidade inteligente nas apps móveis que permite à app lembrar-se de pequenas informações que lhe deste. Pensa nelas como um pequeno bloco de notas onde a app pode apontar coisas de que precisa de se lembrar mais tarde. Por exemplo, uma app que se lembra do teu nome de utilizador, para não teres de o escrever sempre que a abres, usa as Shared Preferences para guardar essa informação. É uma forma fácil e rápida de as apps guardarem dados que não ocupam muito espaço e que têm de estar disponíveis da próxima vez que usas a app.
