| 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) > Settings (Configurações)</strong>). Escolha o painel |
| <strong>Appearance & Behavior (Aparência e comportamento) > System |
| Settings (Configurações do sistema) > Updates (Atualizações)</strong>. |
| |
| <p class="aside">No OSX, é possível encontrar o painel <strong>Appearance & |
| 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) > Settings (Configurações)</strong>). Escolha o painel |
| <strong>Appearance & Behavior (Aparência e comportamento) > System |
| Settings (Configurações do sistema) > Updates (Atualizações)</strong>. |
| |
| <p class="aside">No OSX, é possível encontrar o painel <strong>Appearance & |
| 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 & Behavior (Aparência e comportamento) |
| > System Settings (Configurações do sistema) > 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> |