O recurso "Fontes para download" permite que as APIs solicitem fontes de um aplicativo do provedor, em vez de agrupar arquivos no app ou permitir que o app faça o download de fontes. O "Fontes para download" está disponível em dispositivos com a versão 14 ou mais recente da API do Android usando a biblioteca AndroidX Core.
O recurso "Fontes para download" oferece os seguintes benefícios:
- Reduz o tamanho do app, aumentando a taxa de sucesso da instalação.
- Melhora a integridade geral do sistema, já que vários apps podem compartilhar a mesma fonte usando um provedor. Isso economiza aos usuários os dados móveis, a memória do smartphone e o espaço em disco. Nesse modelo, a fonte é buscada na rede quando necessário.
Como funcionam as Fontes para download?
Um provedor de fontes é um aplicativo que recupera fontes e as armazena em cache localmente para que outros apps possam solicitar e compartilhar fontes. A figura a seguir ilustra o processo.
![Uma imagem mostrando os principais componentes do processo de compatibilidade de emojis](https://developer.android.com/static/guide/topics/ui/images/look-and-feel/downloadable-fonts/downloadable-fonts-process.png?authuser=6&hl=pt)
Noções básicas
Você pode usar o recurso "Fontes para download" das seguintes maneiras, que são discutidas em detalhes em seções posteriores:
- Como usar o Android Studio e o Google Play Services
- De forma programática
- Como usar a biblioteca AndroidX Core
Usar o "Fontes para download" com o Android Studio e o Google Play Services
Você pode configurar seu aplicativo para fazer o download de fontes usando o Android Studio 3.0 ou versões mais recentes. Para ajudar você a começar a usar o recurso "Fontes para download", use o provedor de fontes do Google Play Services.
- No Layout Editor, selecione um
TextView
. Em seguida, em Atributos, selecione fontFamily > Mais fontes.Figura 2. Como usar o Layout Editor. - No menu Source, selecione Google Fonts.
- Na caixa Fontes, selecione uma opção na área "Para download".
- Selecione Criar fonte para download e clique em OK.
Figura 3. Selecione uma fonte na janela Resources.
O Android Studio gera automaticamente os arquivos XML relevantes necessários para renderizar a fonte corretamente no app.
![Uma imagem mostrando como visualizar fontes](https://developer.android.com/static/guide/topics/ui/images/look-and-feel/downloadable-fonts/preview-fonts.png?authuser=6&hl=pt)
Usar o "Fontes para download" de forma programática
A partir do Android 8.0 (nível 26 da API), o AndroidX Core oferece suporte total ao "Fontes para download". Para mais informações sobre o uso da biblioteca AndroidX Core, consulte a seção "Fontes para download da biblioteca AndroidX Core" nesta página.
Para usar o recurso "Fontes para download" de forma programática, interaja com duas classes principais:
android.graphics.fonts.FontRequest
: essa classe permite criar uma solicitação de fonte.FontsContractCompat
: essa classe permite criar um novo objetoTypeface
com base na solicitação de fonte.
O app extrai fontes do provedor de fontes usando a API FontsContract
. Cada
provedor tem o próprio conjunto de restrições para as versões do Android e a linguagem de consulta com suporte. Para
saber mais sobre as versões do Android e o formato de consulta, consulte a documentação
do seu provedor.
Para fazer o download de uma fonte, siga estas etapas:
- Crie uma instância da classe
android.graphics.fonts.FontRequest
para solicitar a fonte do provedor. Para criar uma solicitação, transmita os seguintes parâmetros:- A autoridade do provedor de fontes.
- O pacote de provedor de fontes para confirmar a identidade do provedor.
- A consulta de string da fonte. Para saber mais sobre formatos de consulta, consulte a documentação do seu provedor de fontes, como o Google Fonts.
- Uma lista de conjuntos de hashes para os certificados para verificar a identidade do provedor.
Kotlin
val request = FontRequest( "com.example.fontprovider.authority", "com.example.fontprovider", "my font", certs )
Java
FontRequest request = new FontRequest("com.example.fontprovider", "com.example.fontprovider", "my font", certs);
- Crie uma instância da classe
FontsContract.FontRequestCallback
. - Modifique o
método
onTypefaceRetrieved()
para indicar que a solicitação de fonte foi concluída. Forneça a fonte recuperada como parâmetro. Você pode usar esse método para definir a fonte conforme necessário. Por exemplo, você pode definir a fonte em umTextView
. - Modifique o
método
onTypefaceRequestFailed()
para receber informações sobre erros no processo de solicitação de fonte. Para saber mais sobre códigos de erro, consulte as constantes de código de erro. - Chame o método
FontsContract.requestFont()
para extrair a fonte do provedor de fontes. O método inicia uma verificação para determinar se a fonte existe no cache. Se a fonte não estiver disponível localmente, ele vai chamar o provedor de fontes, recuperar a fonte de forma assíncrona e transmitir o resultado para o callback. Transmita os seguintes parâmetros:- Uma instância da classe
Context
- Uma instância da classe
android.graphics.fonts.FontRequest
- Um callback para receber os resultados da solicitação de fonte
- Um gerenciador para buscar fontes em uma linha de execução
- Uma instância da classe
O exemplo de código a seguir ilustra o processo geral do "Fontes para download":
Kotlin
val request = FontRequest( "com.example.fontprovider.authority", "com.example.fontprovider", "my font", certs ) val callback = object : FontsContract.FontRequestCallback() { override fun onTypefaceRetrieved(typeface: Typeface) { // Your code to use the font goes here. ... } override fun onTypefaceRequestFailed(reason: Int) { // Your code to deal with the failure goes here. ... } } FontsContract.requestFonts(context, request, handler, null, callback)
Java
FontRequest request = new FontRequest("com.example.fontprovider.authority", "com.example.fontprovider", "my font", certs); FontsContract.FontRequestCallback callback = new FontsContract.FontRequestCallback() { @Override public void onTypefaceRetrieved(Typeface typeface) { // Your code to use the font goes here. ... } @Override public void onTypefaceRequestFailed(int reason) { // Your code to deal with the failure goes here. ... } }; FontsContract.requestFonts(context, request, handler, null, callback);
Para saber mais sobre como fazer o download de uma fonte de um provedor de fontes, consulte o app de exemplo DownloadableFonts.
Usar "Fontes para download" com o AndroidX Core
O AndroidX Core oferece suporte ao recurso "Fontes para download" em dispositivos com a versão 14 ou mais recente
da API do Android. O
pacote androidx.core.provider
contém as classes FontsContractCompat
e FontRequest
para implementar
o suporte ao recurso "Fontes para download" compatível com versões anteriores. As classes do AndroidX contêm métodos
semelhantes aos do framework, e o processo de download de fontes é semelhante ao
descrito nesta seção sobre
como usar o "Fontes para download" de forma programática.
Para fazer o download de fontes usando o AndroidX, importe as classes FontsContractCompat
e
FontRequest
do pacote androidx.core.provider
. Crie
instâncias dessas classes em vez das
classes de framework FontsContract
e
android.graphics.fonts.FontRequest
.
Adicionar a dependência do AndroidX Core
Para usar as classes FontsContractCompat
e FontRequest
, modifique
as dependências do caminho de classe do projeto de app no ambiente de desenvolvimento.
Para adicionar o AndroidX Core ao projeto do aplicativo, adicione a seguinte dependência ao arquivo
build.gradle
do app:
Groovy
dependencies { ... implementation "androidx.core:core-ktx:2.2.0" }
Kotlin
dependencies { ... implementation("androidx.core:core-ktx:2.2.0") }
Usar o "Fontes para download" como recursos em XML
O Android 8.0 (nível 26 da API) e o AndroidX Core oferecem uma maneira mais rápida e conveniente de declarar uma fonte personalizada como um recurso no layout XML. Isso significa que não é necessário empacotar a fonte como um recurso. Você pode definir uma fonte personalizada para todo o tema, o que acelera a usabilidade de vários pesos e estilos, como negrito, médio ou leve, quando fornecidos.
- Crie um novo arquivo XML na pasta
res/font
. - Adicione um elemento raiz
<font-family>
e defina os atributos relacionados à fonte, conforme mostrado no exemplo de arquivo XML a seguir: - Faça referência ao arquivo como
@font/font_file_name
no arquivo XML de layout. Você também pode usar o métodogetFont()
para recuperar o arquivo de forma programática, comogetFont(R.font.font_file_name)
.
<?xml version="1.0" encoding="utf-8"?> <font-family xmlns:android="http://schemas.android.com/apk/res/android" android:fontProviderAuthority="com.example.fontprovider.authority" android:fontProviderPackage="com.example.fontprovider" android:fontProviderQuery="example font" android:fontProviderCerts="@array/certs"> </font-family>
Declarar fontes previamente no manifesto
A inflação do layout e a recuperação de recursos são tarefas síncronas. Por padrão, a primeira tentativa de extrair fontes aciona uma solicitação ao provedor de fontes e, portanto, aumenta o tempo do primeiro layout. Para evitar atrasos, você pode declarar previamente as fontes que precisam ser recuperadas no manifesto. Depois que o sistema recupera a fonte do provedor, ela fica disponível imediatamente. Se a recuperação da fonte demorar mais do que o esperado, o sistema cancelará o processo de busca e usará a fonte padrão.
Para declarar as fontes previamente no manifesto, siga estas etapas:
- Crie uma matriz de recursos em
res/values/arrays.xml
e declare as fontes que você quer fazer a pré-busca. - Use uma tag
meta-data
para declarar a matriz de recursos no manifesto.
res/values/arrays.xml <?xml version="1.0" encoding="utf-8"?> <resources> <array name="preloaded_fonts"> <item>@font/font1</item> <item>@font/font2</item> </array> </resources>
<meta-data android:name="preloaded_fonts" android:resource="@array/preloaded_fonts" />
Adicionar certificados
Quando um provedor de fontes não estiver pré-instalado ou se você estiver usando a biblioteca AndroidX Core, declare os certificados com que o provedor de fontes está conectado. O sistema usa os certificados para verificar a identidade do provedor de fontes.
Siga as seguintes etapas para adicionar certificados:
- Crie uma matriz de strings com os detalhes do certificado. Para mais informações sobre detalhes do certificado, consulte a documentação do seu provedor de fontes.
- Defina o atributo
fontProviderCerts
para a matriz.
<?xml version="1.0" encoding="utf-8"?> <resources> <string-array name="certs"> <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item> </string-array> </resources>
android:fontProviderCerts="@array/certs"
Fontes para download no Compose
A partir do Compose 1.2-alpha07, é possível usar a API Downloadable Fonts no app Compose para fazer o download do Google Fonts de forma assíncrona e usá-las no app. Para mais informações, consulte a documentação Fontes para download do Compose.