Livro 4 - Projeto da Previsão do Tempo

4. Configurações iniciais

4.1. Recurso strings.xml

Para o aplicativo vamos precisar dos seguintes recursos strings:

Nome do recurso	Valor
api_key	Escolha sua chave pessoal ou use: 7c0cffe2e25bc681909553be76d060c0
web_service_url	https://api.openweathermap.org/data/2.5/forecast?q=
invalid_url	A URL digitada é inválida.
weather_condition_image	Uma representação gráfica das condições climáticas.
high_temp	Máxima: %s
low_temp	Mínima: %s
day_description	%1$s: %2$s
humidity	Umidade: %s
hint_text	Digite uma cidade (ex: Jaraguá do Sul, SC)
read_error	Não foi possível ler os dados da previsão do tempo.
connect_error	Não foi possível se conectar a OpenWeatherMap.org

Na primeira linha da tabela vemos a definição da chave de API a nível de código. Você pode definir uma chave de acesso de sua conta pessoal do OpenWeatherApp ou usar a disponibilizada na tabela. Na segunda linha vemos uma boa prática de programação para definir um recurso para o endereço da API de modo que a programação nunca faça acesso direto a URL mas haja por intermeio desta variável. Isso possibilita a migração da API no futuro de modo que não impacte a programação em si. Nas próximas linhas existem alguns mensagens de erros que serão mostradas na Snackbar em caso de falhas na comunicação com a API, essas mensagens também são definidas em forma de recurso para facilitar a internacionalização do aplicativo. Por fim, fazemos o uso de strings formatadas com a notação %s, %1$s e %2$s. Essa estratégia é adotada para a geração de mensagens dinâmicas para as temperaturas e umidade de modo que apenas os valores sejam substituídos na hora da conversão.