blob: 894fe430c9800b7e45d6629e493f9673157e0ac0 [file] [log] [blame]
page.title=Configuração do Preview SDK
page.image=images/cards/card-set-up_16-9_2x.png
@jd:body
<div id="qv-wrapper">
<div id="qv">
<h2>Neste documento</h2>
<ol>
<li><a href="#get-as13">Obter o Android Studio 1.3</a></li>
<li><a href="#get-sdk">Obter o Preview SDK</a></li>
<li><a href="#create-update">Criar ou atualizar um projeto</a></li>
<li><a href="#setup-test">Configurar para teste</a></li>
</ol>
</div>
</div>
<p>O M Developer Preview SDK está disponível a partir do Android SDK Manager.
Este documento assume que você está familiarizado com o desenvolvimento de aplicativos do Android,
como o uso do Android SDK Manager e criação de projetos. Caso seja novo no
Android, consulte a lição de treinamento <a href="{@docRoot}training/basics/firstapp/index.html">Como criar o primeiro
aplicativo</a> primeiro.</a></p>
<h2 id="get-as13">Obter o Android Studio 1.3</h2>
<p>A prévia de desenvolvedor é melhor usada com o Android Studio 1.3, que está no estado
de prévia. É altamente recomendado que você instale a versão de prévia
do Android Studio 1.3 para que funcione com o Preview SDK.</p>
<p class="caution"><strong>Cuidado:</strong> a prévia canário do Android
Studio 1.3 ainda está em desenvolvimento ativo. Caso esteja usando a máquina de desenvolvimento principal
para testar a prévia de desenvolvedor, é possível criar uma segunda instalação
do Android Studio para usar em testes.</p>
<p>Para instalar a prévia do Android Studio 1.3:</p>
<ol>
<li>Faça o download e inicie o <a href="{@docRoot}tools/studio/index.html">Android
Studio</a>.
</li>
<li>Abra a janela <strong>Settings (Configurações)</strong> (no Windows, é possível fazer isto
escolhendo <strong>File (Arquivo) &gt; Settings (Configurações)</strong>). Escolha o painel
<strong>Appearance &amp; Behavior (Aparência e comportamento) &gt; System
Settings (Configurações do sistema) &gt; Updates (Atualizações)</strong>.
<p class="aside">No OSX, é possível encontrar o painel <strong>Appearance &amp;
Behavior (Aparência e comportamento)</strong>
na janela <strong>Preferences (Preferências)</strong> do Android Studio.</p>
</li>
<li> No painel <strong>Updates (Atualizações)</strong>, escolha a opção
<strong>Automatically check updates for: Canary Channel (Verificar atualizações automaticamente para: canal canário)</strong>.
</li>
<li>No painel <strong>Updates (Atualizações)</strong>, selecione <strong>Check Now (Verificar agora)</strong>
para verificar a versão mais recente da versão canário. Faça o download e instale a versão
quando solicitado.
</li>
</ol>
<h2 id="get-sdk">Obter o Preview SDK</h2>
<p>Para adicionar os componentes do Preview SDK ao ambiente de desenvolvimento:</p>
<ol>
<li>Inicie a prévia do Android Studio 1.3.
</li>
<li>Abra a janela <strong>Settings (Configurações)</strong> (no Windows, é possível fazer isto
escolhendo <strong>File (Arquivo) &gt; Settings (Configurações)</strong>). Escolha o painel
<strong>Appearance &amp; Behavior (Aparência e comportamento) &gt; System
Settings (Configurações do sistema) &gt; Updates (Atualizações)</strong>.
<p class="aside">No OSX, é possível encontrar o painel <strong>Appearance &amp;
Behavior (Aparência e comportamento)</strong>
na janela <strong>Preferences (Preferências)</strong> do Android Studio.</p>
</li>
<li>No painel <strong>Updates (Atualizações)</strong>, escolha a opção
<strong>Automatically check updates for: Canary Channel (Verificar atualizações automaticamente para: canal canário)</strong> e
<strong>Automatically check atualização for Android SDK: Preview Channel (Verificar atualizações automaticamente para: canal de pré-visualização)</strong>.
</li>
<li>Inicie o <strong>Android SDK Manager</strong>. (Com o Android Studio 1.3,
o SDK Manager está integrado no Android Studio, em vez de ser
um aplicativo independente.)
</li>
<li>Na seção <strong>Platforms (Plataformas)</strong>, selecione <strong>Android MNC
Preview</strong>.
</li>
<li>Na seção <strong>Tools (Ferramentas)</strong>, selecione o Android <strong>
SDK Tools</strong>, <strong>Platform-tools</strong> e
<strong>Build-tools</strong> mais recentes.
</li>
<li>Clique em <strong>Install packages (Instalar pacotes)</strong> e aceite o contrato de licença
para todos os pacotes.
</li>
<li>Verifique se o M Developer Preview está instalado abrindo a janela <strong>
Settings (Configurações)</strong> e escolhendo o painel <strong>Appearance &amp; Behavior (Aparência e comportamento)
&gt; System Settings (Configurações do sistema) &gt; Android SDK</strong>.</li>
<li>No painel <strong>Android SDK</strong>, escolha
a guia <strong>SDK Platforms (Plataformas SDK)</strong>. <strong>Android MNC
Preview</strong> deve estar listado como <em>Installed (Instalado)</em>. Além disso, abra a guia
<strong>SDK Tools (Ferramentas SDK)</strong> para verificar se as ferramentas mais recentes
estão instaladas.
</li>
</ol>
<p>Após concluir estas etapas, os componentes de prévia estarão disponíveis
no ambiente de desenvolvimento. </p>
<h2 id="create-update">Criar ou atualizar um projeto</h2>
<p>
Para usar as APIs de prévia, deve-se criar ou atualizar um projeto de desenvolvimento para usar
os componentes de prévia.
</p>
<h3 id="create">Criar um novo projeto</h3>
<p>
Recomendamos o uso do Android Studio para criar um projeto com a prévia. Siga as etapas
descritas em <a href="{@docRoot}sdk/installing/create-project.html">Criar um projeto</a>
até chegar na tela <em>Form Factors (Novas especificações)</em> no assistente do projeto. Em seguida,
realize as seguintes etapas para criar um projeto configurado para a prévia.
</p>
<ul>
<li>Verifique <strong>Phone and Tablet (Telefone e tablet)</strong>.</li>
<li>Selecione <strong>MNC: Android M (Preview)</strong> em <strong>Minimum
SDK (SDK mínimo)</strong>.</li>
</ul>
<h3 id="update">Atualizar um projeto existente</h3>
<p>
Para projetos existentes, deve-se modificar a configuração de projeto para ativar as APIs de prévia. No
ambiente de desenvolvimento, abra o arquivo <code>build.gradle</code> para o módulo
e defina estes valores da seguinte forma:
</p>
<ul>
<li><code>compileSdkVersion</code> para <code>'android-MNC'</code></li>
<li><code>minSdkVersion</code> para <code>'MNC'</code></li>
<li><code>targetSdkVersion</code> para <code>'MNC'</code></li>
</ul>
<h2 id="setup-test">Configurar para teste</h2>
<p>
Testar um aplicativo com a prévia requer que você tenha um dispositivo ou dispositivo virtual configurado
com a versão de prévia da plataforma. Caso tenha um dispositivo compatível, é possível instalar a plataforma
de prévia para teste. Caso contrário, é possível configurar um dispositivo virtual para o teste.
</p>
<h3 id="setup-device">Configurar um dispositivo físico</h3>
<p>
Caso tenha um Nexus 5, Nexus 6, Nexus 9 ou Android TV, é possível instalar uma imagem do sistema
de prévia nestes dispositivos para testar o aplicativo.
É possível configurar um dispositivo virtual com a versão de prévia da plataforma a partir do Android Studio
usando a ferramenta Android Virtual Device Manager.
</p>
<p class="caution">
<strong>Importante:</strong> instalar uma imagem de prévia em um dispositivo <em>remove todos os dados
dele</em>. Portanto, deve-se realizar o backup de quaisquer dados antes de instalar uma imagem de prévia.
</p>
<h3 id="setupAVD">Configurar um dispositivo virtual</h3>
<p>
É possível configurar um dispositivo virtual com a versão de prévia da plataforma dentro do Android Studio
usando a ferramenta Android Virtual Device Manager.
</p>
<p>Para criar um AVD com o AVD Manager:</p>
<ol>
<li>Instale o Preview SDK no ambiente de desenvolvimento, como descrito
em <a href="{@docRoot}preview/setup-sdk.html">Configurar o Preview
SDK.</a></li>
<li>Siga as etapas em
<a href="{@docRoot}tools/devices/managing-avds.html">Como gerenciar AVDs com
o Gerenciador de AVD</a>. Use as seguintes configurações:
<ul>
<li><strong>Dispositivo:</strong> Nexus 5, Nexus 6, Nexus 9 ou Android TV</li>
<li><strong>Alvo:</strong>
Android M (Preview) - Nível da API M</li>
<li><strong>ABI:</strong> x86</li>
</ul>
</li>
</ol>
<p>
Para obter mais informações sobre como criar dispositivos virtuais para teste, consulte <a href="{@docRoot}tools/devices/index.html">Gerenciamento de dispositivos virtuais</a>.
</p>