zh-cn/source/initializing.html

<html devsite><head>
    <title></title>
    <meta name="project_path" value="/_project.yaml"/>
    <meta name="book_path" value="/_book.yaml"/>
  </head>
  <body>
  <!--
      Copyright 2017 The Android Open Source Project

      Licensed under the Apache License, Version 2.0 (the "License");
      you may not use this file except in compliance with the License.
      You may obtain a copy of the License at

          http://www.apache.org/licenses/LICENSE-2.0

      Unless required by applicable law or agreed to in writing, software
      distributed under the License is distributed on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
      See the License for the specific language governing permissions and
      limitations under the License.
  -->

<p> Android  Linux  Mac OS Windows </p>
<p><a href="life-of-a-patch.html"></a></p>
<h2 id="choosing-a-branch"></h2>
<p><a href="build-numbers.html"></a> <code>master</code></p>
<p></p>
<h2 id="setting-up-a-linux-build-environment"> Linux </h2>
<p> <code>master</code></p>
<p> Ubuntu LTS (14.04)  Android  Ubuntu </p>
<p> Gingerbread (2.3.x)  <code>master</code>  64  32 </p>
<p class="note"><strong></strong><a href="requirements.html"></a> Ubuntu  Mac OS </p>

<h3 id="installing-the-jdk"> JDK</h3>
<p><a href="https://android.googlesource.com/">Android  (AOSP)</a>  Android  <code>master</code>  Java 8 Ubuntu  <a href="http://openjdk.java.net/install/">OpenJDK</a></p>
<p> <a href="requirements.html#jdk">JDK </a></p>

<h4 id="for-ubuntu-15-04"> Ubuntu &gt;= 15.04</h4>
<p></p>
<pre>
$ sudo apt-get update
$ sudo apt-get install openjdk-8-jdk
</pre>

<h4 id="for-ubuntu-14-04"> Ubuntu LTS 14.04</h4>
<p> Ubuntu 14.04  OpenJDK 8 <strong>Ubuntu 15.04 OpenJDK 8</strong>  Ubuntu 14.04 <em> 15.1016.04  Ubuntu 14.04 </em></p>
<ol>
<li>
<p> <a href="http://archive.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/">archive.ubuntu.com</a>  64  <code>.deb</code> </p>
<ul>
<li><a href="http://archive.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/openjdk-8-jre-headless_8u45-b14-1_amd64.deb">openjdk-8-jre-headless_8u45-b14-1_amd64.deb</a>
SHA256<code>0f5aba8db39088283b51e00054813063173a4d8809f70033976f83e214ab56c0</code></li>
<li><a href="http://archive.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/openjdk-8-jre_8u45-b14-1_amd64.deb">openjdk-8-jre_8u45-b14-1_amd64.deb</a>
SHA256<code>9ef76c4562d39432b69baf6c18f199707c5c56a5b4566847df908b7d74e15849</code></li>
<li><a href="http://archive.ubuntu.com/ubuntu/pool/universe/o/openjdk-8/openjdk-8-jdk_8u45-b14-1_amd64.deb">openjdk-8-jdk_8u45-b14-1_amd64.deb</a>
SHA256<code>6e47215cf6205aa829e6a0a64985075bd29d1f428a4006a80c9db371c2fc3c4c</code></li>
</ul>
</li>
<li>
<p> SHA256 </p>
<p> <code>sha256sum</code> </p>
<pre>
$ sha256sum {downloaded.deb file}
</pre>
</li>
<li>
<p></p>
<pre>
$ sudo apt-get update
</pre>
<p> .deb  <code>dpkg</code></p>
<pre>
$ sudo dpkg -i {downloaded.deb file}
</pre>
<p></p>
<pre>
$ sudo apt-get -f install
</pre>
</li>
</ol>

<h4 id="default-java-version"> Java  - </h4>

<p> Ubuntu  Java </p>
<pre>
$ sudo update-alternatives --config java
$ sudo update-alternatives --config javac
</pre>

<p> Java <a href="building.html#wrong-java-version"> Java </a></p>

<h3 id="installing-required-packages-ubuntu-1404"> (Ubuntu 14.04)</h3>

<p> 64  Ubuntu Ubuntu 14.04</p>

<pre>
$ sudo apt-get install git-core gnupg flex bison gperf build-essential \
  zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \
  lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache \
  libgl1-mesa-dev libxml2-utils xsltproc unzip
</pre>

<p class="note"><strong></strong> SELinux  <code>python-networkx</code> </p>

<p class="note"><strong></strong> LDAP  ART  <code>libnss-sss:i386</code> </p>

<h3 id="installing-required-packages-ubuntu-1204"> (Ubuntu 12.04)</h3>

<p> Ubuntu 12.04  Androidmaster  Ubuntu 12.04</p>

<pre>
$ sudo apt-get install git gnupg flex bison gperf build-essential \
  zip curl libc6-dev libncurses5-dev:i386 x11proto-core-dev \
  libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 \
  libgl1-mesa-dev g++-multilib mingw32 tofrodos \
  python-markdown libxml2-utils xsltproc zlib1g-dev:i386
$ sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so
</pre>

<h3 id="installing-required-packages-ubuntu-1004-1110"> (Ubuntu 10.04 - 11.10)</h3>
<p> Ubuntu 10.04-11.10  AOSP</p>

<pre>
$ sudo apt-get install git gnupg flex bison gperf build-essential \
  zip curl zlib1g-dev libc6-dev lib32ncurses5-dev ia32-libs \
  x11proto-core-dev libx11-dev lib32readline5-dev lib32z-dev \
  libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown \
  libxml2-utils xsltproc
</pre>

<p> Ubuntu 10.10 </p>

<pre>
$ sudo ln -s /usr/lib32/mesa/libGL.so.1 /usr/lib32/mesa/libGL.so
</pre>

<p> Ubuntu 11.10 </p>

<pre>
$ sudo apt-get install libx11-dev:i386
</pre>

<h3 id="configuring-usb-access"> USB </h3>

<p> GNU/Linux  Ubuntu  USB </p>
<p> root  <code>/etc/udev/rules.d/51-android.rules</code> </p>

<p> <a href="51-android.txt">51-android.txt</a> </p>

<pre>
$ wget -S -O - http://source.android.com/source/51-android.txt | sed "s/&lt;username&gt;/$USER/" | sudo tee &gt;/dev/null /etc/udev/rules.d/51-android.rules; sudo udevadm control --reload-rules
</pre>

<p></p>

<h3 id="using-a-separate-output-directory"></h3>

<p> <code>out/</code> </p>

<p></p>

<p> <code>OUT_DIR_COMMON_BASE</code> </p>

<pre>
$ export OUT_DIR_COMMON_BASE=&lt;path-to-your-out-directory&gt;
</pre>

<p></p>

<p> <code>/source/master1</code>  <code>/source/master2</code> <code>OUT_DIR_COMMON_BASE</code>  <code>/output</code> <code>/output/master1</code>  <code>/output/master2</code></p>

<p></p>

<p> Jelly Bean (4.1)  <code>master</code> </p>

<h2 id="setting-up-a-mac-os-x-build-environment"> Mac OS </h2>

<p>Mac OS Git  Git  <code>git status</code> AOSP </p>

<p> Mac OS  <code>master</code>  SDK</p>

<h3 id="creating-a-case-sensitive-disk-image"></h3>

<p> Mac OS  25GB Case sensitive, Journaled</p>

<p> shell </p>
<pre>
# hdiutil create -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 40g ~/android.dmg
</pre>

<p> <code>.dmg</code> <code>.dmg.sparseimage</code> Android </p>

<p></p>

<pre>
# hdiutil resize -size &lt;new-size-you-want&gt;g ~/android.dmg.sparseimage
</pre>

<p> <code>android.dmg</code>  <code>~/.bash_profile</code> </p>

<ul>
<li> <code>mountAndroid</code> <p></p>

<pre>
# mount the android file image
function mountAndroid { hdiutil attach ~/android.dmg -mountpoint /Volumes/android; }
</pre>

<p class="note"><strong></strong> <code>.dmg.sparseimage</code>  <code>~/android.dmg</code>  <code>~/android.dmg.sparseimage</code></p>
</li>

<li>
<p> <code>umountAndroid</code> </p>
<pre>
# unmount the android file image
function umountAndroid() { hdiutil detach /Volumes/android; }
</pre>
</li>
</ul>

<p> <code>android</code> </p>

<h3 id="installing-the-mac-jdk"> JDK</h3>

<p> Android  Java <a href="requirements.html"></a></p>

<h4 id="installing-required-packages"></h4>

<ol>
<li>
<p> Xcode </p><pre>
$ xcode-select --install
</pre>

<p> Mac OS10.8  <a href="http://developer.apple.com/">Apple </a> Xcode Apple  Apple ID </p>
</li>

<li>
<p> <a href="http://www.macports.org/install.php">macports.org</a>  MacPorts</p>

<p class="note"><strong></strong> <code>/opt/local/bin</code>  <code>/usr/bin</code> <strong></strong> <code>~/.bash_profile</code> </p>

<pre>
<code>export PATH=/opt/local/bin:$PATH</code>
</pre>

<p class="note"><strong></strong> <code>.bash_profile</code> </p>
</li>

<li>
<p> MacPorts  MakeGit  GPG </p>

<pre>
$ POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg
</pre>

<p> Mac OS X v10.4 bison</p>
<pre>
$ POSIXLY_CORRECT=1 sudo port install bison
</pre>
</li>
</ol>

<h4 id="reverting-from-make-382"> make 3.82 </h4>

<p> Android 4.0.x (Ice Cream Sandwich) gmake 3.82  Android  MacPorts  3.81 </p>

<ol>
<li>
<p> <code>/opt/local/etc/macports/sources.conf</code> rsync </p>
<pre>
file:///Users/Shared/dports
</pre>

<p></p>
<pre>
$ mkdir /Users/Shared/dports
</pre>
</li>

<li>
<p> <code>dports</code> </p>
<pre>
$ svn co --revision 50980 http://svn.macports.org/repository/macports/trunk/dports/devel/gmake/ devel/gmake/
</pre>
</li>

<li>
<p></p>

<pre>
$ portindex /Users/Shared/dports
</pre>
</li>

<li>
<p> gmake</p>
<pre>
$ sudo port install gmake @3.81
</pre>
</li>
</ol>

<h4 id="setting-a-file-descriptor-limit"></h4>

<p> Mac OS </p>

<p> <code>~/.bash_profile</code> </p>
<pre>
# set the number of open files to be 1024
ulimit -S -n 1024
</pre>

<h2 id="optimizing-a-build-environment"></h2>

<h3 id="setting-up-ccache"> ccache</h3>

<p> ccache ccache  C  C++ ccache  <code>make clean</code> ccache</p>

<p class="note"><strong></strong>ccache </p>

<p> ccache</p>

<pre>
$ export USE_CCACHE=1
$ export CCACHE_DIR=/&lt;path_of_your_choice&gt;/.ccache
$ prebuilts/misc/linux-x86/ccache/ccache -M 50G
</pre>

<p> 50G  100G</p>

<p> <code>.bashrc</code></p>

<pre>
export USE_CCACHE=1
</pre>

<p> <code>~/.ccache</code>  NFS  <code>.bashrc</code> </p>

<p> Mac OS  <code>linux-x86</code>  <code>darwin-x86</code></p>

<pre>
prebuilts/misc/darwin-x86/ccache/ccache -M 50G
</pre>

<p> Ice Cream Sandwich (4.0.x) ccache </p>

<pre>
prebuilt/linux-x86/ccache/ccache -M 50G
</pre>

<p> CCACHE_DIR </p>

<p> Linux  ccache </p>

<pre>
$ watch -n1 -d prebuilts/misc/linux-x86/ccache/ccache -s
</pre>

<h2 id="next-download-the-source"></h2>

<p><a href="downloading.html"></a></p>

</body></html>