Observação: o Google Play usa os elementos <uses-library> declarados no manifesto para filtrar o app de dispositivos que não atendem aos requisitos da biblioteca. Para mais informações sobre filtragem, consulte o tópico Filtros do Google Play.
- sintaxe:
-
<uses-library android:name="string" android:required=["true" | "false"] />
- contido em:
-
<application>
- descrição:
- Especifica uma biblioteca compartilhada com a qual o app precisa ser vinculado.
Esse elemento instrui o sistema a incluir o código da biblioteca no carregador de classes do pacote.
Todos os pacotes
android
(comoandroid.app
,android.content
,android.view
eandroid.widget
) estão na biblioteca padrão com a qual todos os aplicativos são automaticamente vinculados. No entanto, alguns pacotes (comomaps
) estão em bibliotecas separadas, que não são vinculadas automaticamente. Consulte a documentação dos pacotes que você está usando para determinar qual biblioteca contém o código do pacote.Esse elemento também afeta a instalação do aplicativo em um dispositivo específico e a disponibilidade dele no Google Play:
- Instalação
- Se este elemento estiver presente e o atributo
android:required
estiver definido comotrue
, o framework dePackageManager
não permitirá que o usuário instale o aplicativo, a menos que a biblioteca esteja presente no dispositivo do usuário.
O atributo
android:required
é descrito em detalhes na próxima seção. - atributos:
-
android:name
- O nome da biblioteca. O nome é fornecido pela documentação do pacote que você está usando. Um exemplo é "
android.test.runner
", um pacote que contém classes de teste do Android. android:required
- Valor booleano que indica se o aplicativo requer a biblioteca especificada por
android:name
:-
"true"
: o aplicativo não funciona sem esta biblioteca. O sistema não permitirá o aplicativo em um dispositivo que não tenha a biblioteca. -
"false"
: o aplicativo pode usar a biblioteca, se presente, mas foi projetado para funcionar sem ela, se necessário. O sistema permitirá que o aplicativo seja instalado, mesmo que a biblioteca não esteja presente. Se você usar"false"
, será responsável por verificar em tempo de execução se a biblioteca está disponível.Para verificar se há uma biblioteca, você pode usar a reflexão para determinar se uma classe específica está disponível.
O padrão é
"true"
.Introduzido em: API de nível 7.
-
- introduzido em:
- API de nível 1
- veja também: