📄 getting_source_code.html
字号:
<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><title>Android - Porting Guide</title><script src="http://www.google.com/uds/api?file=uds.js&v=1.0&key=internal-codesite" type="text/javascript"></script><script src="http://code.google.com/js/jquery.js" type="text/javascript"></script><script type="text/javascript">var _tocPath_ = 'http://code.google.com/android/_toc.ezt';</script><script src="http://code.google.com/js/codesite.pack.01312008.js" type="text/javascript"></script><script language="JavaScript">function resizeHeight() { if(document.getElementById && !(document.all)) { height= document.getElementById('doxygen').contentDocument.body.scrollHeight + 20; document.getElementById('doxygen').style.height = height; } else if(document.all) { height= document.frames('doxygen').document.body.scrollHeight + 20; document.all.doxygen.style.height = height; }}</script><link href="http://code.google.com/css/codesite.pack.01312008.css" type="text/css" rel="stylesheet"></link><!--[if IE]><link rel="stylesheet" type="text/css" href="/css/iehacks.css" /><![endif]--><script src="http://code.google.com/android/assets/search_autocomplete.js"></script><link rel="stylesheet" type="text/css" href="http://code.google.com/css/semantic_headers.css" /><link rel="stylesheet" type="text/css" href="http://code.google.com/android/assets/style.css" /><script> jQuery(document).ready(function() { jQuery("pre").addClass("prettyprint"); }); </script><style type="text/css"><!--h1,h2,h3 { color: #000000;}--></style></head><body class="gc-documentation"><div id="gc-container"><a name="top"></a><div id="skipto"> </div><div id="langpref"> <!--<a class="dropdown" href="/">English</a> <span>|</span> <a href="/more/">Site Directory</a> --></div><div id="gc-header"> <div id="logo"><a href="http://code.google.com/android/index.html"><img src="http://code.google.com/android/images/logo_android.gif" alt="Android"/></a></div> <div id="search" style="inline"> <div id="searchForm" class="searchForm" style="height: 44px;"> <!--previously form was here--> </div> <!-- end searchForm --> <noscript> <style type="text/css"> .searchForm { display : none !important; } .searchForm2 { display : inline !important; } </style> </noscript> <div id="searchForm2" class="searchForm2" style="display:none"> <form id="searchbox_001456098540849067467:6whlsytkdqg" action="http://www.google.com/cse"> <input type="hidden" name="cx" value="001456098540849067467:6whlsytkdqg" /> <input type="hidden" name="cof" value="FORID:0" /> <input type="text" name="q" maxlength="2048" size="41" autocomplete="off" title="Google Code Search"/> <input type="submit" name="sa" value="Search" title="Search"/> <br/> <div class="greytext">e.g. "ajax apis" or "open source"</div> </form> </div> <!-- end searchForm2 --> </div> <!-- end search --></div><!-- end gc-header --><div id="searchControl" class="search-control"></div><!--[if IE]><iframe id="backiFrame" name="backiFrame" src='/dummy.html' style="display:none"></iframe><![endif]--><div id="codesiteContent"><a name="gc-topnav-anchor"></a><div id="gc-topnav"> <h1>Android Platform Development Kit</h1> <ul class="gc-topnav-tabs"> <li id="sdk_link"> <a href="http://code.google.com/android/index.html" title="Android Software Development Kit">SDK</a> </li> <li id="docs_link"> <a href="index.html" title="Official Android documentation">Docs</a> </li> <li id="faq_link"> <a href="http://code.google.com/android/kb/index.html" title="Answers to frequently asked questions about Android">FAQ</a> </li> <li> <a href="http://android-developers.blogspot.com/" title="Official Android blog">Blog</a> </li> <li> <a href="http://code.google.com/android/groups.html" title="Android developer forum">Group</a> </li> <li> <a href="http://code.google.com/android/terms.html" title="Android terms of service">Terms</a> </li> <li> <a href="mailto:android-pdk-feedback@google.com?subject=PDK%20Feedback&body=(filed%20from:%20index.html%20v0.5%20-%2025%20September%202008)%0D%0A%0D%0ASUMMARY:%0D%0A%0D%0A%0D%0A%0D%0ASTEPS%20TO%20REPRODUCE:%0D%0A%0D%0A%0D%0A%0D%0AADDITIONAL%20NOTES:">Report a Problem</a> </li> </ul></div><!-- end gc-topnav --><div class="g-section g-tpl-180"><a name="gc-toc"></a><div class="g-unit g-first" id="gc-toc"> <ul> <li> <h1><a href="index.html">Documentation</a></h1> <ul> <li> <strong>Introduction</strong> <ul> <li><a href="system_requirements.html">Device Requirements</a></li> </ul> </li> <li> <strong>Dev Environment Setup</strong> <ul> <li><a href="source_setup_guide.html">Host System Setup</a></li> <li><a href="getting_source_code.html">Getting Source Code</a></li> <li> <a href="intro_source_code.html">Source Code Overview</a></li> <li><a href="build_system.html">Build System</a></li> </ul> </li> <li> <strong>Basic Bring up</strong> <ul> <li><a href="build_new_device.html">Building New Device</a></li> <li><a href="bring_up.html">Bring up</a></li> <li><a href="keymaps_keyboard_input.html">Keymaps and Keyboard</a></li> <li><a href="display_drivers.html">Display Drivers</a></li> </ul> </li> <li> <strong>Multimedia</strong> <ul> <li><a href="audio_sub_system.html">Audio Subsystem</a></li> <li><a href="camera.html">Camera</a></li> </ul> </li> <li> <strong>Power Management</strong> <ul> <li><a href="power_management.html">Power Management</a></li> </ul> </li> <li> <strong>Networking</strong> <ul> <li><a href="wifi.html">Wi-Fi</a></li> <li><a href="gps.html">GPS</a></li> <li><a href="bluetooth.html">Bluetooth</a></li> </ul> </li> <li> <strong>Telephony</strong> <ul> <li><a href="telephony.html">Radio Interface Layer</a></li> </ul> </li> <li> <strong>Testing</strong> <ul> <li><a href="instrumentation_testing.html">Instrumentation Testing</a></li> </ul> </li> </ul> </li> </ul></div><a name="gc-pagecontent"></a><div class="g-unit" id="gc-pagecontent"><div id="jd-content"><div class="jd-descr"><a name="androidGettingSourceCodeTitle"></a><h1>Getting Source Code</h1><a name="toc"/><div style="padding:10px"><a href="#androidSourceSetupBuildGitSetup">Introduction</a><br/><a href="#androidSourceSetupBuildGitSetupInstall">Installing and Configuring Git</a><br/><a href="#androidSourceSetupBuildGitSetupServer">Establishing Server Access</a><br/><div style="padding-left:40px"><a href="#androidSourceSetupBuildGitSetupServerRSAKeys">Generating RSA Keys</a><br/><a href="#androidSourceSetupBuildGitSetupServerVerifyConnection">Verifying a Connection to the Git Server</a><br/></div><a href="#androidSourceSetupGetCode">Downloading Code</a><br/><a href="#androidSourceSetupExtractingPatch">Extracting an Android Patch</a><br/></div></font></div><a name="androidSourceSetupBuildGitSetup"></a><h2>Introduction</h2><p>Android relies on Git, a version control system, to install the Android platform. You will need to install Git 1.5.2 or greater in order to access the source tree. Please visit <a href="http://git.or.cz/">http://git.or.cz/</a> for more information regarding Git.</p><p>Git permits you to control access to working directories, and we recommend that you use it to limit Android repository access to only a few people within your organization (please refer to your Google NDA for potential contractual restraints on sharing Android source access). </p><p>You may clone Google's repository to a local copy for sharing internally (see Git documentation for details).</p><a name="androidSourceSetupBuildGitSetupInstall"></a><h2>Installing and Configuring Git</h2><p>To install the Git package, execute:</p><pre class="prettyprint">% sudo apt-get install git-core</pre><a name="androidSourceSetupBuildGitSetupServer"></a><h2>Establishing Server Access</h2><p>Once Git is cleanly installed, you need to establish a connection with Google's Git server, a connection that requires an RSA key in order to authenticate requests.</p><a name="androidSourceSetupBuildGitSetupServerRSAKeys"></a><h3>Generating RSA Keys</h3><p>Each developer must have a unique RSA key in order to access Android source code. To generate an RSA key: </p><p><ol><li>Type:<br/><pre class="prettyprint">% ssh-keygen -t rsa -C email@domain.com</pre><br/>You must use a valid email address to create your key.</li><li>When prompted, indicate the file to which you wish to write your key (<code>id_rsa</code> in this example).</li><li>When prompted, associate a passphrase with your key.</li><li>Upon success, you should have two files saved to the designated directory: </li><ul> <li><code>id_rsa</code>: This file contains the private half of your RSA key. You shouldn't share this file with anyone. </li> <li><code>id_rsa.pub</code>: This is the public half or your RSA key and you should send it to your Google technical account manager.</li> </ul></ol></p><p>Send your Google Account Manager your public key file in order to establish Git server access. </p><a name="androidSourceSetupBuildGitSetupServerVerifyConnection"></a><h3>Verifying a Connection to the Git Server</h3><p>Once you have generated an RSA key and shared the public file with Google, you can test your connection with the Git server with the following command:</p><pre class="prettyprint">% ssh android-git.ext.google.com</pre><p>You should receive one of the following results:</p><table border=1 cellpadding=2 cellspacing=0> <tbody><tr> <th scope="col">Result</th> <th scope="col">Cause</th> <th scope="col">Action</th> </tr> <tr> <td><code>fatal: What do you think I am? A shell?<BR>Connection to android-git closed.</code></pre> </td> <td>Success</td> <td>None. You successfully connected to the Git server. (You should not have shell access and it's expected to receive this error.)</td> </tr> <tr> <td>ssh hangs and eventually times out. </td> <td>Your setup is failing to locate and establish a basic connection. </td> <td>Google needs to debug network settings. </td> </tr> <tr> <td>Error: Permission denied <public key> </td> <td>Either you are not using the matching username or the RSA private key does not match the public key. </td> <td>Try executing:<BR> <code>% ssh $USER@android- git.ext.google.com</code></td> </tr></table><a name="androidSourceSetupGetCode"></a><h2>Downloading Code</h2><p>Android source code is maintained in two repositories: <code>device</code> and <code>kernel</code>. The <code>device</code> repository includes the Android framework (things like the Activity Manager, Window Manager, Telephony Manager, View System, etc.). The <code>kernel</code> repository includes the core code necessary to run the operating system (things like the Display Driver, Camera Driver, Keypad Driver, Power Management, etc.). (Please see <a href="http://code.google.com/android/what-is-android.html">What is Android?</a> for details.)</p><p>Save device and kernel code at the same directory level, for example:</p><p><ul><li><code>/home/joe/android/device</code></li><li><code>/home/joe/android/kernel</code></li></ul></p><p><b>Device Code</b></p><p>To download device code, you need your username and a unique <code><path></code> string supplied by Google to execute the following:</p><pre class="prettyprint">% git-clone $USER@android-git.ext.google.com:<path>/device.git</pre><p><b>Kernel Code</b></p><p>To download kernel code, you need your username and a unique <code><path></code> string supplied by Google to execute the following:</p><pre class="prettyprint">% git-clone $USER@android-git.ext.google.com:<path>/kernel.git</pre> <a name="androidSourceSetupExtractingPatch"></a><h2>Extracting an Android Patch</h2><p>You likely already have Linux running on your platform and only need to integrate Android-specific changes. The following directions describe how to extract an Android patch.</p><ol> <li>Download a generic version of the Linux kernel that matches the Linux version downloaded with the Android Kernel code.</li> <li>Run <code>diff</code> on the two kernel packages to get Android-specific changes.</li> <li>Apply the patch to your target kernel and build.</li></ol><p><span class="lh2"><a name="androidFooter"></a></span> </div> </div> <!-- end gc-pagecontent --> </div> <!-- end gooey wrapper --> </div> <!-- end codesearchresults --> <div id="gc-footer" dir="ltr"> <div class="text"> ©2008 Google<!-- - <a href="/">Code Home</a> - <a href="http://www.google.com/accounts/TOS">Site Terms of Service</a> - <a href="http://www.google.com/privacy.html">Privacy Policy</a> - <a href="/more">Site Directory</a> --></div> </div> <!-- end gc-footer --></div><!-- end gc-containter --><script src="http://www.google-analytics.com/ga.js" type="text/javascript"></script><script type="text/javascript"> try { var pageTracker = _gat._getTracker("UA-18071-1"); pageTracker._setAllowAnchor(true); pageTracker._initData(); pageTracker._trackPageview(); } catch(e) {}</script><div id="jd-build-id"> v0.5 - 25 September 2008</div></div></div></div></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -