1page.title=Configuração do Preview SDK 2page.image=images/cards/card-set-up_16-9_2x.png 3 4@jd:body 5 6 7<div id="qv-wrapper"> 8 <div id="qv"> 9 <h2>Neste documento</h2> 10 <ol> 11 <li><a href="#get-as13">Obter o Android Studio 1.3</a></li> 12 <li><a href="#get-sdk">Obter o Preview SDK</a></li> 13 <li><a href="#create-update">Criar ou atualizar um projeto</a></li> 14 <li><a href="#setup-test">Configurar para teste</a></li> 15 </ol> 16 </div> 17</div> 18 19<p>O M Developer Preview SDK está disponível a partir do Android SDK Manager. 20Este documento assume que você está familiarizado com o desenvolvimento de aplicativos do Android, 21como o uso do Android SDK Manager e criação de projetos. Caso seja novo no 22Android, consulte a lição de treinamento <a href="{@docRoot}training/basics/firstapp/index.html">Como criar o primeiro 23aplicativo</a> primeiro.</a></p> 24 25<h2 id="get-as13">Obter o Android Studio 1.3</h2> 26 27<p>A prévia de desenvolvedor é melhor usada com o Android Studio 1.3, que está no estado 28de prévia. É altamente recomendado que você instale a versão de prévia 29do Android Studio 1.3 para que funcione com o Preview SDK.</p> 30 31<p class="caution"><strong>Cuidado:</strong> a prévia canário do Android 32Studio 1.3 ainda está em desenvolvimento ativo. Caso esteja usando a máquina de desenvolvimento principal 33para testar a prévia de desenvolvedor, é possível criar uma segunda instalação 34do Android Studio para usar em testes.</p> 35 36<p>Para instalar a prévia do Android Studio 1.3:</p> 37 38<ol> 39 <li>Faça o download e inicie o <a href="{@docRoot}tools/studio/index.html">Android 40 Studio</a>. 41 </li> 42 43 <li>Abra a janela <strong>Settings (Configurações)</strong> (no Windows, é possível fazer isto 44 escolhendo <strong>File (Arquivo) > Settings (Configurações)</strong>). Escolha o painel 45 <strong>Appearance & Behavior (Aparência e comportamento) > System 46 Settings (Configurações do sistema) > Updates (Atualizações)</strong>. 47 48 <p class="aside">No OSX, é possível encontrar o painel <strong>Appearance & 49 Behavior (Aparência e comportamento)</strong> 50 na janela <strong>Preferences (Preferências)</strong> do Android Studio.</p> 51 </li> 52 53 <li> No painel <strong>Updates (Atualizações)</strong>, escolha a opção 54 <strong>Automatically check updates for: Canary Channel (Verificar atualizações automaticamente para: canal canário)</strong>. 55 </li> 56 57 <li>No painel <strong>Updates (Atualizações)</strong>, selecione <strong>Check Now (Verificar agora)</strong> 58 para verificar a versão mais recente da versão canário. Faça o download e instale a versão 59 quando solicitado. 60 </li> 61</ol> 62 63<h2 id="get-sdk">Obter o Preview SDK</h2> 64 65<p>Para adicionar os componentes do Preview SDK ao ambiente de desenvolvimento:</p> 66 67<ol> 68 <li>Inicie a prévia do Android Studio 1.3. 69 </li> 70 71 <li>Abra a janela <strong>Settings (Configurações)</strong> (no Windows, é possível fazer isto 72 escolhendo <strong>File (Arquivo) > Settings (Configurações)</strong>). Escolha o painel 73 <strong>Appearance & Behavior (Aparência e comportamento) > System 74 Settings (Configurações do sistema) > Updates (Atualizações)</strong>. 75 76 <p class="aside">No OSX, é possível encontrar o painel <strong>Appearance & 77 Behavior (Aparência e comportamento)</strong> 78 na janela <strong>Preferences (Preferências)</strong> do Android Studio.</p> 79 </li> 80 81 <li>No painel <strong>Updates (Atualizações)</strong>, escolha a opção 82 <strong>Automatically check updates for: Canary Channel (Verificar atualizações automaticamente para: canal canário)</strong> e 83 <strong>Automatically check atualização for Android SDK: Preview Channel (Verificar atualizações automaticamente para: canal de pré-visualização)</strong>. 84 </li> 85 86 <li>Inicie o <strong>Android SDK Manager</strong>. (Com o Android Studio 1.3, 87 o SDK Manager está integrado no Android Studio, em vez de ser 88 um aplicativo independente.) 89 </li> 90 91 <li>Na seção <strong>Platforms (Plataformas)</strong>, selecione <strong>Android MNC 92 Preview</strong>. 93 </li> 94 95 <li>Na seção <strong>Tools (Ferramentas)</strong>, selecione o Android <strong> 96SDK Tools</strong>, <strong>Platform-tools</strong> e 97<strong>Build-tools</strong> mais recentes. 98 </li> 99 100 <li>Clique em <strong>Install packages (Instalar pacotes)</strong> e aceite o contrato de licença 101 para todos os pacotes. 102 </li> 103 104 <li>Verifique se o M Developer Preview está instalado abrindo a janela <strong> 105Settings (Configurações)</strong> e escolhendo o painel <strong>Appearance & Behavior (Aparência e comportamento) 106> System Settings (Configurações do sistema) > Android SDK</strong>.</li> 107 108 <li>No painel <strong>Android SDK</strong>, escolha 109 a guia <strong>SDK Platforms (Plataformas SDK)</strong>. <strong>Android MNC 110 Preview</strong> deve estar listado como <em>Installed (Instalado)</em>. Além disso, abra a guia 111 <strong>SDK Tools (Ferramentas SDK)</strong> para verificar se as ferramentas mais recentes 112 estão instaladas. 113 </li> 114</ol> 115<p>Após concluir estas etapas, os componentes de prévia estarão disponíveis 116 no ambiente de desenvolvimento. </p> 117 118 119<h2 id="create-update">Criar ou atualizar um projeto</h2> 120 121<p> 122 Para usar as APIs de prévia, deve-se criar ou atualizar um projeto de desenvolvimento para usar 123 os componentes de prévia. 124</p> 125 126 127<h3 id="create">Criar um novo projeto</h3> 128 129<p> 130 Recomendamos o uso do Android Studio para criar um projeto com a prévia. Siga as etapas 131 descritas em <a href="{@docRoot}sdk/installing/create-project.html">Criar um projeto</a> 132 até chegar na tela <em>Form Factors (Novas especificações)</em> no assistente do projeto. Em seguida, 133 realize as seguintes etapas para criar um projeto configurado para a prévia. 134</p> 135 136<ul> 137 <li>Verifique <strong>Phone and Tablet (Telefone e tablet)</strong>.</li> 138 <li>Selecione <strong>MNC: Android M (Preview)</strong> em <strong>Minimum 139 SDK (SDK mínimo)</strong>.</li> 140</ul> 141 142 143<h3 id="update">Atualizar um projeto existente</h3> 144 145<p> 146 Para projetos existentes, deve-se modificar a configuração de projeto para ativar as APIs de prévia. No 147 ambiente de desenvolvimento, abra o arquivo <code>build.gradle</code> para o módulo 148 e defina estes valores da seguinte forma: 149</p> 150 151<ul> 152 <li><code>compileSdkVersion</code> para <code>'android-MNC'</code></li> 153 <li><code>minSdkVersion</code> para <code>'MNC'</code></li> 154 <li><code>targetSdkVersion</code> para <code>'MNC'</code></li> 155</ul> 156 157 158<h2 id="setup-test">Configurar para teste</h2> 159 160<p> 161 Testar um aplicativo com a prévia requer que você tenha um dispositivo ou dispositivo virtual configurado 162 com a versão de prévia da plataforma. Caso tenha um dispositivo compatível, é possível instalar a plataforma 163 de prévia para teste. Caso contrário, é possível configurar um dispositivo virtual para o teste. 164</p> 165 166<h3 id="setup-device">Configurar um dispositivo físico</h3> 167 168<p> 169 Caso tenha um Nexus 5, Nexus 6, Nexus 9 ou Android TV, é possível instalar uma imagem do sistema 170 de prévia nestes dispositivos para testar o aplicativo. 171 É possível configurar um dispositivo virtual com a versão de prévia da plataforma a partir do Android Studio 172 usando a ferramenta Android Virtual Device Manager. 173</p> 174 175<p class="caution"> 176 <strong>Importante:</strong> instalar uma imagem de prévia em um dispositivo <em>remove todos os dados 177 dele</em>. Portanto, deve-se realizar o backup de quaisquer dados antes de instalar uma imagem de prévia. 178</p> 179 180<h3 id="setupAVD">Configurar um dispositivo virtual</h3> 181 182<p> 183 É possível configurar um dispositivo virtual com a versão de prévia da plataforma dentro do Android Studio 184 usando a ferramenta Android Virtual Device Manager. 185</p> 186 187<p>Para criar um AVD com o AVD Manager:</p> 188 189<ol> 190 <li>Instale o Preview SDK no ambiente de desenvolvimento, como descrito 191 em <a href="{@docRoot}preview/setup-sdk.html">Configurar o Preview 192 SDK.</a></li> 193 <li>Siga as etapas em 194 <a href="{@docRoot}tools/devices/managing-avds.html">Como gerenciar AVDs com 195 o Gerenciador de AVD</a>. Use as seguintes configurações: 196 <ul> 197 <li><strong>Dispositivo:</strong> Nexus 5, Nexus 6, Nexus 9 ou Android TV</li> 198 <li><strong>Alvo:</strong> 199 Android M (Preview) - Nível da API M</li> 200 <li><strong>ABI:</strong> x86</li> 201 </ul> 202 </li> 203</ol> 204 205<p> 206 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>. 207</p> 208