David Friedman | 9c0bb4f | 2015-07-07 21:30:41 -0700 | [diff] [blame] | 1 | page.title=Configuração do Preview SDK |
| 2 | page.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. |
| 20 | Este documento assume que você está familiarizado com o desenvolvimento de aplicativos do Android, |
| 21 | como o uso do Android SDK Manager e criação de projetos. Caso seja novo no |
| 22 | Android, consulte a lição de treinamento <a href="{@docRoot}training/basics/firstapp/index.html">Como criar o primeiro |
| 23 | aplicativo</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 |
| 28 | de prévia. É altamente recomendado que você instale a versão de prévia |
| 29 | do 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 |
| 32 | Studio 1.3 ainda está em desenvolvimento ativo. Caso esteja usando a máquina de desenvolvimento principal |
| 33 | para testar a prévia de desenvolvedor, é possível criar uma segunda instalação |
| 34 | do 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> |
| 96 | SDK 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> |
| 105 | Settings (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> |