Qual é a diferença entre compileSdkVersion e targetSdkVersion?

Examinei a documentação para criar com Gradle, mas ainda não tenho certeza de qual é a diferença entre compileSdkVersione targetSdkVersioné.

Tudo o que diz é:

A compileSdkVersionpropriedade especifica o destino da compilação.

Bem, qual é o "destino de compilação"?

Eu vejo duas maneiras possíveis de interpretar isso:

1. compileSdkVersioné a versão do compilador usada na criação do aplicativo, enquanto targetSdkVersioné o "nível da API que o aplicativo segmenta" . (Se fosse esse o caso, eu suponho que compileSdkVersiondeve ser maior ou igual ao targetSdkVersion?
2. Eles significam a mesma coisa. "destino de compilação" == "o nível da API que o aplicativo segmenta"
3. Algo mais?

Vejo que essa pergunta já foi feita antes, mas a resposta apenas cita o documento, que é o que não está claro para mim.

compileSdkVersion

A compileSdkVersioné a versão da API na qual o aplicativo é compilado. Isso significa que você pode usar os recursos da API do Android incluídos nessa versão da API (bem como em todas as versões anteriores, obviamente). Se você tentar usar os recursos da API 16, mas definido compileSdkVersioncomo 15, você receberá um erro de compilação. Se você definir compileSdkVersion16, ainda poderá executar o aplicativo em um dispositivo API 15, desde que os caminhos de execução do aplicativo não tentem invocar nenhuma API específica da API 16.

targetSdkVersion

O targetSdkVersionnada tem a ver com a forma como seu aplicativo é compilado ou APIs que você pode utilizar. O targetSdkVersioné suposto para indicar que você testou seu aplicativo on (presumivelmente até e incluindo) a versão que você especificar. É mais como uma certificação ou aprovação que você está dando ao sistema operacional Android como uma dica de como ele deve lidar com seu aplicativo em termos de recursos do sistema operacional.

Por exemplo, como a documentação declara:

Por exemplo, definir esse valor como "11" ou superior permite que o sistema aplique um novo tema padrão (Holo) ao seu aplicativo ao executar no Android 3.0 ou superior ...

O sistema operacional Android, em tempo de execução , pode alterar a forma como seu aplicativo é estilizado ou executado no contexto do sistema operacional com base nesse valor. Existem alguns outros exemplos conhecidos que são influenciados por esse valor e essa lista provavelmente aumentará apenas com o tempo.

Para todos os fins práticos, a maioria dos aplicativos deseja definir targetSdkVersiona versão mais recente da API. Isso garantirá que seu aplicativo tenha a melhor aparência possível nos dispositivos Android mais recentes. Se você não especificar o targetSdkVersion, o padrão será o minSdkVersion.

Como um guia oneliner:

minSdkVersion <= targetSdkVersion <= compileSdkVersion

Idealmente:

minSdkVersion (lowest possible) <= targetSdkVersion == compileSdkVersion (latest SDK)

Leia mais deste ótimo post de Ian Lake

A compileSdkVersiondeve ser a versão estável mais recente. O teste targetSdkVersiondeve ser totalmente testado e menor ou igual a compileSdkVersion.

Tarde do jogo .. e há várias ótimas respostas acima - basicamente, essa compileSdkVersioné a versão da API na qual o aplicativo é compilado, enquanto otargetSdkVersion indica a versão em que o aplicativo foi testado.

Gostaria de complementar essas respostas com as seguintes notas:

1. Isso targetSdkVersionafeta a maneira como as permissões são solicitadas :

   • Se o dispositivo estiver executando o Android 6.0 (nível 23 da API) ou superior, e o aplicativotargetSdkVersion for 23 ou superior, o aplicativo solicitará permissões do usuário em tempo de execução.
   • Se o dispositivo estiver executando o Android 5.1 (nível de API 22) ou inferior, ou o aplicativo targetSdkVersionfor 22 ou inferior, o sistema solicitará que o usuário conceda as permissões quando o usuário instalar o aplicativo.

2. Se compileSdkVersionfor maior que a versão declarada pelo seu aplicativo targetSdkVersion, o sistema poderá ativar comportamentos de compatibilidade para garantir que seu aplicativo continue funcionando da maneira que você espera. ( ref )

3. A cada nova versão do Android ...

   • targetSdkVersion deve ser incrementado para corresponder ao nível mais recente da API e, em seguida, teste minuciosamente seu aplicativo na versão da plataforma correspondente
   • compileSdkVersion, por outro lado, não precisa ser alterado, a menos que você esteja adicionando recursos exclusivos à nova versão da plataforma
   • Como resultado, embora targetSdkVersionmuitas vezes seja (inicialmente) menor que o compileSdkVersion, não é incomum ver um aplicativo bem mantido / estabelecido comtargetSdkVersion > compileSdkVersion

The CompileSdkVersion é a versão da plataforma SDK com a qual seu aplicativo trabalha para compilação, etc. DURANTE o processo de desenvolvimento (você deve sempre usar as mais recentes). É fornecida com a versão da API que você está usando

Você verá isso no seu build.gradlearquivo:

targetSdkVersion:contém as informações fornecidas pelo aplicativo APÓS o processo de desenvolvimento para a loja de aplicativos que permite TARGET the SPECIFIED version of the Android platform. Dependendo da funcionalidade do seu aplicativo, ele pode segmentar versões da API inferiores às atuais. Por exemplo, você pode segmentar a API 18, mesmo que a versão atual seja 23.

Dê uma boa olhada nesta página oficial do Google .

Eu vejo muitas diferenças sobre compiledSdkVersion nas respostas anteriores, então tentarei esclarecer um pouco aqui, seguindo a página da web do android.

A - O que diz o Android

De acordo com https://developer.android.com/guide/topics/manifest/uses-sdk-element.html :

Selecionando uma versão da plataforma e o nível da API Ao desenvolver seu aplicativo, você precisará escolher a versão da plataforma na qual compilará o aplicativo. Em geral, você deve compilar seu aplicativo com a versão mais baixa possível da plataforma que ele puder suportar.

Portanto, essa seria a ordem correta de acordo com o Android:

compiledSdkVersion = minSdkVersion <= targetSdkVersion

B - O que os outros também dizem

Algumas pessoas preferem sempre usar a versão compilada mais alta do Skd disponível. Isso ocorre porque eles contam com dicas de código para verificar se estão usando recursos de API mais recentes que o minSdkVersion, alterando o código para não usá-los ou verificando a versão da API do usuário em tempo de execução para usá-los condicionalmente com fallbacks de versões mais antigas da API.

As dicas sobre usos descontinuados também apareceriam no código, informando que algo está descontinuado nos níveis mais recentes da API, para que você possa reagir adequadamente, se desejar.

Portanto, essa seria a ordem correta de acordo com os outros:

minSdkVersion <= targetSdkVersion <= compiledSdkVersion (highest possible)

O que fazer?

Depende de você e seu aplicativo.

Se você planeja oferecer recursos diferentes da API de acordo com o nível da API do usuário em tempo de execução, use a opção B. Você obterá dicas sobre os recursos que você usa durante a codificação. Apenas certifique-se de nunca usar os recursos mais recentes da API que o minSdkVersion sem verificar o nível da API do usuário em tempo de execução, caso contrário, seu aplicativo falhará. Essa abordagem também tem o benefício de aprender o que há de novo e o que é antigo durante a codificação.

Se você já sabe o que é novo ou antigo e está desenvolvendo um aplicativo único que com certeza nunca será atualizado, ou tem certeza de que não oferecerá novos recursos de API condicionalmente, use a opção A. Você não será incomodado com dicas descontinuadas e você nunca poderá usar os recursos mais recentes da API, mesmo se estiver tentado a fazê-lo.

Meus 2 centavos: compile com qualquer versão do SDK, mas tome cuidado para não chamar APIs que sua "versão mínima do SDK" não oferece suporte. Isso significa que você "poderia" compilar com a versão mais recente do SDK.

Quanto à "versão de destino", ela simplesmente se refere ao que você planejou atingir em primeiro lugar e possivelmente testou. Se você não fez a devida diligência, esta é a maneira de informar ao Android que ele precisa executar algumas verificações adicionais antes de implantar o seu, digamos, o aplicativo direcionado "Lollipop" no "Oreo".

Portanto, a "versão de destino" obviamente não é inferior à sua "versão mínima do SDK", mas não pode ser superior à sua "versão compilada".

Não respondendo às suas perguntas diretas, uma vez que já existem muitas respostas detalhadas, mas vale a pena mencionar que, ao contrário da documentação do Android, o Android Studio está sugerindo o uso da mesma versão para compileSDKVersione targetSDKVersion.

compiledSdkVersion ==> qual versão do SDK deve compilar seu código no ponto de bytecode (usado no ambiente de desenvolvimento): é melhor usar a última versão do SDK.

minSdkVersion ==> esses itens são usados ​​para a instalação do APK (usado no ambiente de produção). Por exemplo:

if(client-sdk-version   <   min-sdk-versoin )
    client-can-not-install-apk;
else
    client-can-install-apk;

Resumo rápido:

Para minSDKversion, consulte a entrada mais recente no identificador do twitter: https://twitter.com/minSdkVersion

TargetSDKversion: veja a entrada mais recente no identificador do twitter: https://twitter.com/targtSdkVersion ou use o nível de API mais recente, conforme indicado em devel https://developer.android.com/guide/topics/manifest/uses-sdk-element. html

Versão compilada: faça o mesmo que o TargetSDKversion

maxSdkVersion: o conselho do Android é não definir isso, pois você não deseja limitar seu aplicativo a não executar em futuras versões do Android

As configurações de aplicativo das propriedades de um projeto Android no Visual Studio 2017 (15.8.5) as combinam: