Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8d869520 authored by Scott Main's avatar Scott Main
Browse files

docs: misc edits to samples page and intro docs 

make samples page accessible from offline version instead
of redirecting to the user filesystem and include instructions
for creating projects based on the sample apps.
fix a link and add some content to the What is android doc.

bug: 2160782
parent e33044ea

docs/html/guide/basics/what-is-android.jd

+7 −1
Original line number Original line Diff line number Diff line
@@ -3,7 +3,7 @@ page.title=What is Android? 




<p>Android is a software stack for mobile devices that includes an operating

<p>Android is a software stack for mobile devices that includes an operating

system, middleware and key applications. The <a

system, middleware and key applications. The <a

href="http://code.google.com/android/download.html">Android SDK</a>

href="http://developer.android.com/sdk/index.html">Android SDK</a>

provides the tools and APIs necessary to begin developing applications on the

provides the tools and APIs necessary to begin developing applications on the

Android platform using the Java programming language.</p>

Android platform using the Java programming language.</p>
@@ -48,6 +48,12 @@ others. All applications are written using the Java programming language.</p> 
<a name="application_framework" id="application_framework"></a>

<a name="application_framework" id="application_framework"></a>

<h2>Application Framework</h2>

<h2>Application Framework</h2>





<p>By providing an open development platform, Android

offers developers the ability to build extremely rich and innovative

applications. Developers are free to take advantage of the

device hardware, access location information, run background services, set alarms,

add notifications to the status bar, and much, much more. </p>



<p>Developers have full access to the same framework APIs used by the core

<p>Developers have full access to the same framework APIs used by the core

applications. The application architecture is designed to simplify the reuse

applications. The application architecture is designed to simplify the reuse

of components; any application can publish its capabilities and any other

of components; any application can publish its capabilities and any other

docs/html/guide/guide_toc.cs

+57 −62
Original line number Original line Diff line number Diff line
@@ -9,25 +9,26 @@ 




  <li>

  <li>

    <h2><span class="en">Android Basics</span>

    <h2><span class="en">Android Basics</span>

        <span class="de">Einführung in Android</span>

        <span class="de" style="display:none">Einführung in Android</span>

        <span class="es">Información básica sobre Android</span>

        <span class="es" style="display:none">Información básica sobre Android</span>

        <span class="fr">Présentation d'Android</span>

        <span class="fr" style="display:none">Présentation d'Android</span>

        <span class="it">Nozioni di base su Android</span>

        <span class="it" style="display:none">Nozioni di base su Android</span>

        <span class="ja">Android の基本</span>

        <span class="ja" style="display:none">Android の基本</span>

        <span class="zh-CN">Android 基础知识</span>

        <span class="zh-CN" style="display:none">Android 基础知识</span>

        <span class="zh-TW">Android 簡介</span>

        <span class="zh-TW" style="display:none">Android 簡介</span>

    </h2>

    </h2>

    <ul>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/basics/what-is-android.html">

      <li><a href="<?cs var:toroot ?>guide/basics/what-is-android.html">

        <span class="en">What Is Android?</span>

        <span class="en">What Is Android?</span>

        <span class="de">Was ist Android?</span>

        <span class="de" style="display:none">Was ist Android?</span>

        <span class="es">¿Qué es Android?</span>

        <span class="es" style="display:none">¿Qué es Android?</span>

        <span class="fr">Qu'est-ce qu'Android&nbsp;?</span>

        <span class="fr" style="display:none">Qu'est-ce qu'Android&nbsp;?</span>

        <span class="it">Che cos'è Android?</span>

        <span class="it" style="display:none">Che cos'è Android?</span>

        <span class="ja">Android とは</span>

        <span class="ja" style="display:none">Android とは</span>

        <span class="zh-CN">Android 是什么？</span>

        <span class="zh-CN" style="display:none">Android 是什么？</span>

        <span class="zh-TW">什麼是 Android？</span>

        <span class="zh-TW" style="display:none">什麼是 Android？</span>

          </a></li>

          </a></li>



  <!--  <li><a style="color:gray;">The Android SDK</a></li> -->

  <!--  <li><a style="color:gray;">The Android SDK</a></li> -->

  <!--  <li><a style="color:gray;">Walkthrough for Developers</a></li> -->

  <!--  <li><a style="color:gray;">Walkthrough for Developers</a></li> -->

      <!-- quick overview of what it's like to develop on Android -->

      <!-- quick overview of what it's like to develop on Android -->
@@ -37,13 +38,13 @@ 
  <li>

  <li>

    <h2>

    <h2>

      <span class="en">Framework Topics</span>

      <span class="en">Framework Topics</span>

      <span class="de">Framework-Themen</span>

      <span class="de" style="display:none">Framework-Themen</span>

      <span class="es">Temas sobre el framework</span>

      <span class="es" style="display:none">Temas sobre el framework</span>

      <span class="fr">Thèmes relatifs au framework</span>

      <span class="fr" style="display:none">Thèmes relatifs au framework</span>

      <span class="it">Argomenti relativi al framework</span>

      <span class="it" style="display:none">Argomenti relativi al framework</span>

      <span class="ja">フレームワーク トピック</span>

      <span class="ja" style="display:none">フレームワーク トピック</span>

      <span class="zh-CN">框架主题</span>

      <span class="zh-CN" style="display:none">框架主题</span>

      <span class="zh-TW">架構主題</span>

      <span class="zh-TW" style="display:none">架構主題</span>

    </h2>

    </h2>

    <ul>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/topics/fundamentals.html">

      <li><a href="<?cs var:toroot ?>guide/topics/fundamentals.html">
@@ -202,13 +203,13 @@ 
  

  

  <li>

  <li>

    <h2><span class="en">Developing</span>

    <h2><span class="en">Developing</span>

               <span class="de">Entwicklung</span>

               <span class="de" style="display:none">Entwicklung</span>

               <span class="es">Desarrollo</span>

               <span class="es" style="display:none">Desarrollo</span>

               <span class="fr">Développement</span>

               <span class="fr" style="display:none">Développement</span>

               <span class="it">Sviluppo</span>

               <span class="it" style="display:none">Sviluppo</span>

               <span class="ja">開発</span>

               <span class="ja" style="display:none">開発</span>

               <span class="zh-CN">开发</span>

               <span class="zh-CN" style="display:none">开发</span>

               <span class="zh-TW">開發</span>

               <span class="zh-TW" style="display:none">開發</span>

    </h2>

    </h2>

    <ul>

    <ul>

  <!--<li><a href="">Developing for Android</a></li>

  <!--<li><a href="">Developing for Android</a></li>
@@ -270,13 +271,13 @@ 
  

  

  <li>

  <li>

    <h2><span class="en">Publishing</span>

    <h2><span class="en">Publishing</span>

        <span class="de">Veröffentlichung</span>

        <span class="de" style="display:none">Veröffentlichung</span>

        <span class="es">Publicación</span>

        <span class="es" style="display:none">Publicación</span>

        <span class="fr">Publication</span>

        <span class="fr" style="display:none">Publication</span>

        <span class="it">Pubblicazione</span>

        <span class="it" style="display:none">Pubblicazione</span>

        <span class="ja">公開</span>

        <span class="ja" style="display:none">公開</span>

        <span class="zh-CN">发布</span>

        <span class="zh-CN" style="display:none">发布</span>

        <span class="zh-TW">發佈</span>

        <span class="zh-TW" style="display:none">發佈</span>

    </h2>

    </h2>

    <ul>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/publishing/app-signing.html">

      <li><a href="<?cs var:toroot ?>guide/publishing/app-signing.html">
@@ -317,13 +318,13 @@ 
  

  

  <li>

  <li>

    <h2><span class="en">Best Practices</span>

    <h2><span class="en">Best Practices</span>

               <span class="de">Bewährte Verfahren</span>

               <span class="de" style="display:none">Bewährte Verfahren</span>

               <span class="es">Prácticas recomendadas</span>

               <span class="es" style="display:none">Prácticas recomendadas</span>

               <span class="fr">Meilleures pratiques</span>

               <span class="fr" style="display:none">Meilleures pratiques</span>

               <span class="it">Best practice</span>

               <span class="it" style="display:none">Best practice</span>

               <span class="ja">ベスト プラクティス</span>

               <span class="ja" style="display:none">ベスト プラクティス</span>

               <span class="zh-CN">最佳实践</span>

               <span class="zh-CN" style="display:none">最佳实践</span>

               <span class="zh-TW">最佳實務</span>

               <span class="zh-TW" style="display:none">最佳實務</span>

    </h2>

    </h2>

    <ul>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/practices/screens_support.html">

      <li><a href="<?cs var:toroot ?>guide/practices/screens_support.html">
@@ -364,13 +365,13 @@ 
  

  

  <li>

  <li>

    <h2><span class="en">Tutorials and Sample Code</span>

    <h2><span class="en">Tutorials and Sample Code</span>

               <span class="de">Lernprogramme und Beispielcode</span>

               <span class="de" style="display:none">Lernprogramme und Beispielcode</span>

               <span class="es">Tutoriales y código de ejemplo</span>

               <span class="es" style="display:none">Tutoriales y código de ejemplo</span>

               <span class="fr">Didacticiels et exemple de code</span>

               <span class="fr" style="display:none">Didacticiels et exemple de code</span>

               <span class="it">Esercitazioni e codice di esempio</span>

               <span class="it" style="display:none">Esercitazioni e codice di esempio</span>

               <span class="ja">チュートリアルとサンプル コード</span>

               <span class="ja" style="display:none">チュートリアルとサンプル コード</span>

               <span class="zh-CN">辅导手册和示例代码</span>

               <span class="zh-CN" style="display:none">辅导手册和示例代码</span>

               <span class="zh-TW">教學課程與程式碼範例</span>

               <span class="zh-TW" style="display:none">教學課程與程式碼範例</span>

    </h2>

    </h2>

    <ul>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/tutorials/hello-world.html">

      <li><a href="<?cs var:toroot ?>guide/tutorials/hello-world.html">
@@ -387,11 +388,6 @@ 
          </a></li>

          </a></li>

    </ul>

    </ul>

    <ul>

    <ul>

    <?cs if:android.whichdoc != "online" ?>

      <li><a href="<?cs var:toroot ?>../platforms/android-<?cs var:sdk.version ?>/samples">

            <span class="en">Sample Code</span>

          &raquo;</a></li>

    <?cs else ?>

      <li class="toggle-list">

      <li class="toggle-list">

        <div><a href="<?cs var:toroot ?>guide/samples/index.html">

        <div><a href="<?cs var:toroot ?>guide/samples/index.html">

               <span class="en">Sample Code</span>

               <span class="en">Sample Code</span>
@@ -423,20 +419,19 @@ 
              </a></li>

              </a></li>

        </ul>

        </ul>

      </li>

      </li>

    <?cs /if ?>

    </ul>

    </ul>

  </li>

  </li>

  

  





  <li>

  <li>

    <h2><span class="en">Appendix</span>

    <h2><span class="en">Appendix</span>

               <span class="de">Anhang</span>

               <span class="de" style="display:none">Anhang</span>

               <span class="es">Apéndice</span>

               <span class="es" style="display:none">Apéndice</span>

               <span class="fr">Annexes</span>

               <span class="fr" style="display:none">Annexes</span>

               <span class="it">Appendice</span>

               <span class="it" style="display:none">Appendice</span>

               <span class="ja">付録</span>

               <span class="ja" style="display:none">付録</span>

               <span class="zh-CN">附录</span>

               <span class="zh-CN" style="display:none">附录</span>

               <span class="zh-TW">附錄</span>

               <span class="zh-TW" style="display:none">附錄</span>

    </h2>

    </h2>

    <ul>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/appendix/api-levels.html">

      <li><a href="<?cs var:toroot ?>guide/appendix/api-levels.html">

docs/html/guide/samples/index.jd

+36 −10
Original line number Original line Diff line number Diff line
@@ -3,28 +3,44 @@ page.title=Sample Code 
@jd:body

@jd:body









<p>Sometimes, the best way to learn how things are done is to just look at some code. So here

<p>Sometimes, the best way to learn how things are done is to look at some code.

 we've provided links to let you browse the source of some sample Android applications included

Here, you can browse the source of some sample Android applications that are included

in the Android SDK.</p>

in the Android SDK.</p>





<p>The SDK includes a full set of sample applications for each Android platform version 

<p>Each version of the Android platform available for the SDK includes a full set of sample

in the SDK. You can find the sample applications for each platform version in this location:</p>

applications (which may vary between different versions of the platform).

You can find the samples in your SDK at:</p>





<p style="margin-left:2em"><code>&lt;sdk&gt;/platforms/android-&lt;version&gt;/samples/</code></p>

<p style="margin-left:2em">

<code><em>&lt;sdk&gt;</em>/platforms/android-<em>&lt;version&gt;</em>/samples/</code>

</p>



<p>You can easily create new Android projects with these samples, modify them

if you'd like, then run them on an emulator or device. For example, to create

a project for the API Demos app from Eclipse,

start a new Android Project, select "Create project from existing source", then select

{@code ApiDemos} in the {@code samples/} directory. To create the API Demos project

using the {@code android} tool, execute:</p>

<pre>

android update project -s -n API Demos -t <em>&lt;target_ID></em> -p <em>&lt;path-to-platform></em>/samples/ApiDemos/

</pre>



<p>The pages below provide an overview of each sample application (available with most

platforms) and allow you to view the source files in your browser. </p>





<p>You can easily add these applications as projects in your development environment, so that you 

can modify them and watch them execute. </p>

<dl>

<dl>





 <dt><a href="ApiDemos/index.html">API Demos</a></dt>

 <dt><a href="ApiDemos/index.html">API Demos</a></dt>

  <dd>A variety of small applications that demonstrate an extensive collection of framework topics.</dd>

  <dd>A variety of small applications that demonstrate an extensive collection of

  framework topics.</dd>

  

  

 <dt><a href="Home/index.html">Home</a></dt>

 <dt><a href="Home/index.html">Home</a></dt>

  <dd>An application for saving notes. Similar (but not identical) to the 

  <dd>An application for saving notes. Similar (but not identical) to the 

    <a href="{@docRoot}guide/tutorials/notepad/index.html">Notepad tutorial</a>.</dd>

    <a href="{@docRoot}guide/tutorials/notepad/index.html">Notepad tutorial</a>.</dd>

  

  

 <dt><a href="JetBoy/index.html">JetBoy</a></dt>

 <dt><a href="JetBoy/index.html">JetBoy</a></dt>

  <dd>JetBoy is a game that demonstrates the SONiVOX JET interactive music technology, with {@link android.media.JetPlayer}.</dd>

  <dd>JetBoy is a game that demonstrates the SONiVOX JET interactive music technology,

  with {@link android.media.JetPlayer}.</dd>

    

    

 <dt><a href="LunarLander/index.html">Lunar Lander</a></dt>

 <dt><a href="LunarLander/index.html">Lunar Lander</a></dt>

  <dd>A classic Lunar Lander game.</dd>

  <dd>A classic Lunar Lander game.</dd>
@@ -44,3 +60,13 @@ can modify them and watch them execute. </p> 
  <dd>An example of writing an input method for a software keyboard.</dd>

  <dd>An example of writing an input method for a software keyboard.</dd>

    

    

</dl>

</dl>





<div class="special">

<p>For more sample applications, check out

<a href="http://code.google.com/p/apps-for-android/">apps-for-android</a>, a

collection of open source applications that demonstrate various Android APIs.

</p>

</div>

docs/html/samples/index.jd

deleted100644 → 0
+0 −22
Original line number Original line Diff line number Diff line 
page.title=Android SDK

page.onlyfortemplate=codesite

@jd:body

<h1>Sample Code</h1>



<p>The Android SDK ships with several sample projects. They are:</p>



<dl>

    <dt><a href="{@docRoot}samples/ApiDemos/index.html">API Demos</a></dt>

    <dd>A demonstration of many of the Android APIs.</dd>

    

    <dt><a href="{@docRoot}samples/LunarLander/index.html">Lunar Lander</a></dt>

    <dd>Your objective: to land on the moon.</dd>



    <dt><a href="{@docRoot}samples/NotePad/index.html">Note Pad</a></dt>

    <dd>A simple note pad application.</dd>    

</dl>



<p>To run these samples, you should <a

href="{@docRoot}guide/developing/eclipse-adt.html#creatingaproject">import them into

Eclipse</a> or build them with Ant, as described in 

<a href="{@docRoot}guide/developing/other-ide.html#Building">Developing in Other IDEs</a>.</p>