docs/html-intl/intl/zh-cn/preview/setup-sdk.jd

page.title=设置预览版 SDK
page.image=images/cards/card-set-up_16-9_2x.png

@jd:body


<div id="qv-wrapper">
  <div id="qv">
    <h2>本文内容</h2>
      <ol>
        <li><a href="#get-as13">获取 Android Studio 1.3</a></li>
        <li><a href="#get-sdk">获取预览版 SDK</a></li>
        <li><a href="#create-update">创建或更新项目</a></li>
        <li><a href="#setup-test">测试设置</a></li>
      </ol>
  </div>
</div>

<p>M 开发者预览版 SDK 可通过 Android SDK 管理器获取。本文假定您熟悉 Android 应用开发的相关操作，例如：使用 Android SDK 管理器和创建项目。

如果您是首次使用 Android，请先参阅<a href="{@docRoot}training/basics/firstapp/index.html">开发您的第一款应用</a>培训课程。</a>

</p>

<h2 id="get-as13">获取 Android Studio 1.3</h2>

<p>开发者预览版与处于预览版状态的 Android Studio 1.3 结合使用时效果最佳。
强烈建议您安装 Android Studio 1.3 的预览版本，以便与预览版 SDK 结合使用。
</p>

<p class="caution"><strong>注意：</strong>Android Studio 1.3 的 Canary 预览版仍处于活动的开发状态。
如果您正使用主要开发机器测试开发者预览版，则可创建另一套 Android Studio 安装系统供测试使用。

</p>

<p>要安装 Android Studio 1.3 预览版，请执行以下操作：</p>

<ol>
  <li>下载并启动 <a href="{@docRoot}tools/studio/index.html">Android Studio</a>。

  </li>

  <li>打开<strong>设置</strong>窗口（在 Windows 中，您可通过选择<strong>文件 &gt; 设置</strong>执行此操作）。
选择<strong>外观和行为 &gt; 系统设置 &gt; 更新</strong>面板。



    <p class="aside">在 OSX 中，您可在 Android Studio 的<strong>首选项</strong>窗口中找到<strong>外观和行为</strong>面板。

</p>
  </li>

  <li> 在<strong>更新</strong>面板中，选择选项<strong>自动检查更新:
Canary 渠道</strong>。
  </li>

  <li>在<strong>更新</strong>面板中，选择<strong>立即检查</strong>，以检查最新的 Canary 内部版本。
当系统出现提示时，请下载并安装该内部版本。

  </li>
</ol>

<h2 id="get-sdk">获取预览版 SDK</h2>

<p>要将预览版 SDK 组件添加到开发环境，请执行以下操作：</p>

<ol>
  <li>启动 Android Studio 1.3 预览版。
  </li>

  <li>打开<strong>设置</strong>窗口（在 Windows 中，您可通过选择<strong>文件 &gt; 设置</strong>执行此操作）。
选择<strong>外观和行为 &gt; 系统设置 &gt; 更新</strong>面板。



    <p class="aside">在 OSX 中，您可在 Android Studio 的<strong>首选项</strong>窗口中找到<strong>外观和行为</strong>面板。

</p>
  </li>

  <li>在<strong>更新</strong>面板中，选择选项<strong>自动检查更新:
Canary 渠道</strong>和<strong>自动检查 Android SDK 的更新:
预览版渠道</strong>。
  </li>

  <li>启动 <strong>Android SDK 管理器</strong>。（对于 Android Studio 1.3，SDK 管理器已集成至 Android Studio，而不是独立应用。）


  </li>

  <li>在<strong>平台</strong>部分下，选择 <strong>Android MNC 预览版</strong>。

  </li>

  <li>在<strong>工具</strong>部分中，选择最新的 Android <strong>SDK 工具</strong>、<strong>平台工具</strong>和<strong>构建工具</strong>。


  </li>

  <li>点击<strong>安装软件包</strong>并接受所有软件包的许可协议。

  </li>

  <li>验证是否已安装 M 开发者预览版，具体方式如下：打开<strong>设置</strong>窗口并选择<strong>外观与行为 &gt; 系统设置 &gt; Android SDK</strong> 面板。

</li>

  <li>在 <strong>Android SDK</strong> 面板中，选择 <strong>SDK 平台</strong>选项卡。
<strong>Android MNC 预览版</strong>应作为“已安装”列出<em></em>。
另外，打开 <strong>SDK 工具</strong>选项卡，确认是否已安装最新工具。


  </li>
</ol>
<p>完成上述步骤后，预览版组件即可用于您的开发环境。
 </p>


<h2 id="create-update">创建或更新项目</h2>

<p>
  为使用预览版 API，您必须创建或更新一个使用预览版组件的开发项目。

</p>


<h3 id="create">创建新项目</h3>

<p>
  建议使用 Android Studio 创建一个使用该预览版的项目。按照<a href="{@docRoot}sdk/installing/create-project.html">创建项目</a>中所描述的步骤操作，直到转到项目向导中的“外形”<em></em>屏幕为止。

然后执行下列步骤，创建为该预览版配置的项目。

</p>

<ul>
  <li>选中<strong>手机和平板电脑</strong>。</li>
  <li>选择 <strong>MNC:Android M (预览版)</strong>（在<strong>最低 SDK</strong> 中）。
</li>
</ul>


<h3 id="update">更新现有项目</h3>

<p>
  对于现有项目，您必须修改项目配置以启用预览版 API。在开发环境中，打开模块的 <code>build.gradle</code> 文件，并按如下所示设置这些值：


</p>

<ul>
  <li>将 <code>compileSdkVersion</code> 设置为 <code>'android-MNC'</code></li>
  <li>将 <code>minSdkVersion</code> 设置为 <code>'MNC'</code></li>
  <li>将 <code>targetSdkVersion</code> 设置为 <code>'MNC'</code></li>
</ul>


<h2 id="setup-test">测试设置</h2>

<p>
  要使用预览版测试应用，您必须拥有已配置平台预览版本的物理设备或虚拟设备。
如果您拥有兼容设备，则可安装预览版平台进行测试。
另外，您可以配置用于测试的虚拟设备。
</p>

<h3 id="setup-device">设置物理设备</h3>

<p>
  如果您拥有 Nexus 5、Nexus 6、Nexus 9 或 Android TV，则可在这些设备中安装预览版系统映像，来测试您的应用。通过使用 Android 虚拟设备管理器工具，您可从 Android Studio 内设置带有平台预览版本的虚拟设备。



</p>

<p class="caution">
  <strong>重要说明：</strong>在设备中安装预览版映像会删除此设备中的所有数据，因此您应在安装预览版映像之前备份数据。<em></em>

</p>

<h3 id="setupAVD">设置虚拟设备</h3>

<p>
  通过使用 Android 虚拟设备管理器工具，您可从 Android Studio 内设置带有平台预览版本的虚拟设备。

</p>

<p>要使用 AVD 管理器创建 AVD，请执行以下操作：</p>

<ol>
  <li>在开发环境中安装预览版 SDK，如<a href="{@docRoot}preview/setup-sdk.html">设置预览版 SDK</a> 中所述。

</li>
  <li>按照<a href="{@docRoot}tools/devices/managing-avds.html">使用 AVD 管理器管理 AVD </a>中的步骤操作。

使用以下设置：
    <ul>
      <li><strong>设备：</strong>Nexus 5、Nexus 6、Nexus 9 或 Android TV</li>
      <li><strong>目标：</strong>
       Android M（预览版）- API 级别 M</li>
      <li><strong>ABI：</strong>x86</li>
    </ul>
  </li>
</ol>

<p>
  如需了解有关创建测试用虚拟设备的详细信息，请参阅<a href="{@docRoot}tools/devices/index.html">管理虚拟设备</a>。
</p>