<uses-library>

Observação: o Google Play usa os elementos <uses-library> declarados no manifesto para filtrar o app dos dispositivos que não atendem aos requisitos da biblioteca. Para mais informações sobre filtros, consulte Filtros no Google Play.

Sintaxe:
<uses-library
  android:name="string"
  android:required=["true" | "false"] />
contido em:
<application>
descrição:

Especifica uma biblioteca compartilhada que precisa ser vinculada ao aplicativo. Esse elemento instrui o sistema a incluir o código da biblioteca no carregador de classes do pacote.

Todos os pacotes android, como android.app, android.content, android.view e android.widget, estão na biblioteca padrão com que todos os aplicativos são automaticamente vinculados. No entanto, alguns pacotes, como maps, 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.

A ordem das tags <uses-library> é significativa. Ela afeta a pesquisa de classes e a ordem de resolução quando o aplicativo é carregado. Algumas das bibliotecas podem ter classes duplicadas e, nesse caso, a biblioteca que vem primeiro tem prioridade.

Esse elemento também afeta a instalação do aplicativo em dispositivos específicos e a disponibilidade do app no Google Play. Se este elemento estiver presente e o atributo android:required estiver definido como "true", o framework de PackageManager não vai 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 é o "android.test.runner", um pacote que contém classes de teste do Android.
android:required
Valor booleano que indica se o aplicativo exige a biblioteca especificada por android:name.
  • "true": o aplicativo não funciona sem essa biblioteca. O sistema não permite que o aplicativo seja instalado em um dispositivo que não tenha a biblioteca.
  • "false": o aplicativo usa a biblioteca se ela estiver presente, mas foi criado para funcionar sem ela, se necessário. O sistema permite que o aplicativo seja instalado, mesmo que a biblioteca não esteja presente. Se usar "false", você será responsável por conferir se a biblioteca está disponível durante a execução.

    Para consultar se uma biblioteca está disponível, você pode usar a reflexão para determinar se uma classe específica está presente.

O padrão é "true".

Introduzido no nível 7 da API.

introduzido em:
Nível 1 da API
veja também: