docs/howto/setup_development_environment_on_windows/zh.html

<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<style>
h1,
h2,
h3,
h4,
h5,
h6,
p,
blockquote {
    margin: 0;
    padding: 0;
}
body {
    font-family: "Helvetica Neue", Helvetica, "Hiragino Sans GB", Arial, sans-serif;
    font-size: 13px;
    line-height: 18px;
    color: #737373;
    background-color: white;
    margin: 10px 13px 10px 13px;
}
table {
	margin: 10px 0 15px 0;
	border-collapse: collapse;
}
td,th {	
	border: 1px solid #ddd;
	padding: 3px 10px;
}
th {
	padding: 5px 10px;	
}

a {
    color: #0069d6;
}
a:hover {
    color: #0050a3;
    text-decoration: none;
}
a img {
    border: none;
}
p {
    margin-bottom: 9px;
}
h1,
h2,
h3,
h4,
h5,
h6 {
    color: #404040;
    line-height: 36px;
}
h1 {
    margin-bottom: 18px;
    font-size: 30px;
}
h2 {
    font-size: 24px;
}
h3 {
    font-size: 18px;
}
h4 {
    font-size: 16px;
}
h5 {
    font-size: 14px;
}
h6 {
    font-size: 13px;
}
hr {
    margin: 0 0 19px;
    border: 0;
    border-bottom: 1px solid #ccc;
}
blockquote {
    padding: 13px 13px 21px 15px;
    margin-bottom: 18px;
    font-family:georgia,serif;
    font-style: italic;
}
blockquote:before {
    content:"\201C";
    font-size:40px;
    margin-left:-10px;
    font-family:georgia,serif;
    color:#eee;
}
blockquote p {
    font-size: 14px;
    font-weight: 300;
    line-height: 18px;
    margin-bottom: 0;
    font-style: italic;
}
code, pre {
    font-family: Monaco, Andale Mono, Courier New, monospace;
}
code {
    background-color: #fee9cc;
    color: rgba(0, 0, 0, 0.75);
    padding: 1px 3px;
    font-size: 12px;
    -webkit-border-radius: 3px;
    -moz-border-radius: 3px;
    border-radius: 3px;
}
pre {
    display: block;
    padding: 14px;
    margin: 0 0 18px;
    line-height: 16px;
    font-size: 11px;
    border: 1px solid #d9d9d9;
    white-space: pre-wrap;
    word-wrap: break-word;
}
pre code {
    background-color: #fff;
    color:#737373;
    font-size: 11px;
    padding: 0;
}
sup {
    font-size: 0.83em;
    vertical-align: super;
    line-height: 0;
}
* {
	-webkit-print-color-adjust: exact;
}
@media screen and (min-width: 914px) {
    body {
        width: 854px;
        margin:10px auto;
    }
}
@media print {
	body,code,pre code,h1,h2,h3,h4,h5,h6 {
		color: black;
	}
	table, pre {
		page-break-inside: avoid;
	}
}
</style>
<title>设置 Quick-Cocos2d-x 在 Windows 下的编译环境</title>

</head>
<body>
<h1>设置 Quick-Cocos2d-x 在 Windows 下的编译环境</h1>

<p>配置编译环境的基本步骤：</p>

<ol>
<li>下载 Quick-Cocos2d-x 源代码</li>
<li>设置运行环境</li>
<li>安装 Java SDK</li>
<li>安装最新的 Android ADT bundle 和 Android NDK</li>
<li>编译 LuaJavaBridge 示例，并在 Android 真机上进行测试</li>
</ol>


<h2>Step 1: 下载 Quick-Cocos2d-x 源代码</h2>

<p>访问 <a href="https://github.com/chukong/quick-cocos2d-x/releases">https://github.com/chukong/quick-cocos2d-x/releases</a> 下载最新版 quick 源代码。</p>

<p>由于 <strong> Android SDK </strong> 和 <strong> NDK </strong> 的问题，<strong> Quick-Cocos2d-x 目录的放置有一定要求 </strong> ：</p>

<ol>
<li>必须和 Android SDK/NDK 在同一个分区</li>
<li>不能放在根目录</li>
<li>路径中不能包含中文和空格（所以别放桌面了）</li>
</ol>


<p>~</p>

<h2>Step 2: 设置运行环境</h2>

<p>运行 <strong>setup_win.bat</strong>，完成运行环境的设置工作，成功会看到如下界面：</p>

<p><img src="res/howto_setup_development_environment_windows_00.png" alt="" /></p>

<p>启动 <strong>player/win/player.exe</strong>，即可运行示例和您的项目。</p>

<p><img src="res/howto_setup_development_environment_windows_00_.png" alt="" /></p>

<p>~</p>

<h2>Step 3: 安装 Java SDK</h2>

<p>从 <a href="http://www.oracle.com/technetwork/java/javase/downloads/">http://www.oracle.com/technetwork/java/javase/downloads/</a> 下载最新版的 Java SDK，并进行安装。</p>

<p>~</p>

<h2>Step 4: 安装最新的 Android ADT bundle 和 Android NDK</h2>

<p>1.从 <a href="http://developer.android.com/sdk/">http://developer.android.com/sdk/</a> 下载最新的 <strong> ADT Bundle for Windows </strong>。</p>

<p>2.解压缩 adt-bundle-windows-x86-2014????.zip 。</p>

<p>3.将目录 adt-bundle-windows-x86-2014???? 改名为 android 。</p>

<p>4.将目录 android\sdk 改名为 android\android-sdk-windows 。</p>

<p>5.从 <a href="http://developer.android.com/tools/sdk/ndk/index.html">http://developer.android.com/tools/sdk/ndk/index.html</a> 下载 Android NDK r9?</p>

<p>6.解压缩 android-ndk-r9?-windows-x86.zip</p>

<p>7.将目录 android-ndk-r9? 移动到 android\android-ndk-r9?</p>

<pre><code>最终的目录结构:
</code></pre>

<pre><code>
    &lt;PATH_TO&gt;\android\android-ndk-r9?
    &lt;PATH_TO&gt;\android\android-sdk-windows
    &lt;PATH_TO&gt;\android\eclipse
</code></pre>

<p><img src="res/howto_setup_development_environment_windows_01.png" alt="" /></p>

<p>8.运行 <strong> android\android-sdk-windows\tools\android.bat </strong> , 选中 <strong> Android SDK 2.2 </strong>（ <strong> 如果看不到 Android SDK 2.2，请设置代理 </strong> ）, 然后安装需要的包。</p>

<p><img src="res/howto_setup_development_environment_windows_02.png" alt="" /></p>

<p>~</p>

<h2>Step 5: 编译 LuaJavaBridge 示例，并在 Android 真机上进行测试</h2>

<p>启动 命令行提示符 程序, 改变当前目录为 &lt;PATH_TO>\Quick-cocos2d-x\sample\luajavabridge\proj.android, 运行 build_native.bat:</p>

<pre><code>
cd Quick-cocos2d-x\sample\luajavabridge\proj.android
build_native.bat
</code></pre>

<p>如果一切正常，等待几分钟以后会看到如下信息：</p>

<pre><code>
SharedLibrary  : libgame.so
Install        : libgame.so =&gt; libs/armeabi/libgame.so
</code></pre>

<h3>将项目导入 Eclipse ADT</h3>

<p>启动 &lt;PATH_TO>\eclipse\eclipse.exe, 导入 <strong> libcocos2dx </strong> 库（这个库是 Cocos2d-x 的 Java 支持）.</p>

<p>1.选择菜单 <strong> File </strong> -> <strong> Import </strong>, 再选择 <strong> Android </strong> -> <strong> Existing Android Code Into Workspace </strong> :</p>

<p><img src="res/howto_setup_development_environment_windows_06.png" alt="" /></p>

<p>2.点击 <strong> Browse </strong> 按钮, 选择 <strong> \Quick-cocos2d-x\lib\cocos2d-x\cocos2dx\platform\android\java </strong> 目录:</p>

<p><img src="res/howto_setup_development_environment_windows_07.png" alt="" /></p>

<p>3.点击 Finish.</p>

<p>4.重复上述步骤, 将 <strong> luajavabridge\proj.android </strong> 目录导入 Eclipse:</p>

<p><img src="res/howto_setup_development_environment_windows_08.png" alt="" /></p>

<p>5.在左侧 <strong> Package Explorer </strong> 里的 <strong> LuajavaBridge </strong> 项目上点击鼠标右键，选择菜单 <strong> Properties </strong> :</p>

<p><img src="res/howto_setup_development_environment_windows_09.png" alt="" /></p>

<p>6.如果 <strong> Library </strong> 中已经存在 <strong> libcocos2dx </strong> 项，请先删除。然后点击 <strong> Add </strong> 按钮, 再选择添加 <strong> libcocos2dx </strong> 库.</p>

<p><img src="res/howto_setup_development_environment_windows_10.png" alt="" /></p>

<p>7.导入完成。</p>

<h3>设置 Android 设备允许真机调试</h3>

<p>Android 官方文档：<a href="http://developer.android.com/tools/device.html">http://developer.android.com/tools/device.html</a></p>

<ol>
<li>Enable USB debugging on your device.

<ul>
<li>On most devices running Android 3.2 or older, you can find the option under Settings > Applications > Development.</li>
<li>On Android 4.0 and newer, it’s in Settings > Developer options.</li>
</ul>


<p> Note: On Android 4.2 and newer, Developer options is hidden by default. To make it available, go to Settings > About phone and tap Build number seven times. Return to the previous screen to find Developer options.</p>

<ul>
<li>在系统设置中找到“开发者选项”，打开“USB调试”。</li>
</ul>
</li>
<li>Set up your system to detect your device.

<ul>
<li>If you’re developing on Windows, you need to install a USB driver for adb. For an installation guide and links to OEM drivers, see the OEM USB Drivers document.</li>
<li>根据不同的机型，也许需要安装该机型特定的 USB 驱动程序。例如 Moto 就必须安装 Moto 的 USB 驱动。</li>
</ul>
</li>
</ol>


<h3>在设备上测试 LuaJavaBridge 示例</h3>

<p>1.在 Eclipse 里选择菜单 <strong> Window </strong> -> <strong> Show View </strong> -> <strong> Other… </strong> , 再选择 <strong> Android </strong> -> <strong> Devices </strong>.</p>

<p>2.如果设备设置完成，并且安装了正确的 USB 驱动，那么在 Devices 标签页中就可以看到你的设备:</p>

<p><img src="res/howto_setup_development_environment_windows_11.png" alt="" /></p>

<p>如果看不到设备，请仔细检查设备设置和驱动程序。</p>

<p>3.在项目 <strong> LuajavaBridge </strong> 上点击鼠标右键, 选择菜单 <strong> Debug As </strong> -> <strong> Android Application </strong>. 如果一切正常，等一会儿就可以在设备上看到运行画面了：</p>

<p><img src="res/howto_setup_development_environment_windows_12.png" alt="" /></p>

<p>-EOF-</p>
</body>
</html>