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

Commit 5cdadb48 authored by Scott Main's avatar Scott Main
Browse files

initial shuffle of the API guide nav to add introduction 

* revise to the Compatibility doc, put it in Intro
* put Permissions in Intro
* put App Fundamentals in Intro
* move Manifest docs to the top of side nav tree
* move App Resources above UI
Will perform another fix to the Best Practices section
later to deprecate some docs there and point to Training instead

Change-Id: I88a8f94167ba15e97eb3bbbc08fd82dd82498e4b
parent ed4b7faa

docs/html/guide/components/fundamentals.jd

+183 −205

File changed.

Preview size limit exceeded, changes collapsed.

docs/html/guide/components/index.jd

+1 −1
Original line number Diff line number Diff line 
page.title=App Components

page.landing=true

page.landing.intro=Android's application framework lets you create extremely rich and innovative apps using a set of reusable components. This section explains how Android apps work and how you use components to build them. 

page.landing.intro=Android's application framework lets you create rich and innovative apps using a set of reusable components. This section explains how you can build the components that define the building blocks of your app and how to connect them together using intents. 

page.landing.image=images/develop/app_components.png



@jd:body

docs/html/guide/guide_toc.cs

+106 −161
Original line number Diff line number Diff line
@@ -6,17 +6,41 @@ 
       localized titles are added in the language order specified below.

?>

<ul id="nav">

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

  <!--<li style="color:red">Overview</li> -->



  <li class="nav-section">

    <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/components/index.html">

        <span class="en">App Components</span>

    <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/index.html">

        <span class="en">Introduction</span>

      </a></div>

    <ul>

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

            <span class="en">App Fundamentals</span></a>

      </li>

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

            <span class="en">Device Compatibility</span>

          </a></li>

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

          <span class="en">System Permissions</span>

        </a>

      </li>

    </ul>

  </li>





  <li class="nav-section">

    <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/components/index.html">

        <span class="en">App Components</span>

      </a></div>

    <ul>

      <li class="nav-section">

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/components/intents-filters.html">

            <span class="en">Intents and Intent Filters</span>

          </a></div>

        <ul>

          <li><a href="<?cs var:toroot ?>guide/components/intents-common.html">

            <span class="en">Common Intents</span>

          </a></li>

        </ul>

      </li>

      <li class="nav-section">

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/components/activities.html">

            <span class="en">Activities</span>
@@ -69,12 +93,12 @@ 
        </ul>

      </li>

      <li class="nav-section">

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/components/intents-filters.html">

            <span class="en">Intents and Intent Filters</span>

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/appwidgets/index.html">

            <span class="en">App Widgets</span>

          </a></div>

        <ul>

          <li><a href="<?cs var:toroot ?>guide/components/intents-common.html">

            <span class="en">Common Intents</span>

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

              <span class="en">App Widget Host</span>

            </a></li>

        </ul>

      </li>
@@ -82,23 +106,53 @@ 
          <span class="en">Processes and Threads</span>

        </a>

      </li>

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

          <span class="en">Permissions</span>

        </a>

    </ul>

  </li>





  <li class="nav-section">

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/appwidgets/index.html">

            <span class="en">App Widgets</span>

    <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/resources/index.html">

         <span class="en">App Resources</span>

       </a></div>

    <ul>

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

              <span class="en">App Widget Host</span>

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

          <span class="en">Overview</span>

        </a></li>

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

          <span class="en">Providing Resources</span>

        </a></li>

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

          <span class="en">Accessing Resources</span>

        </a></li>

      <li><a href="<?cs var:toroot ?>guide/topics/resources/runtime-changes.html">

            <span class="en">Handling Runtime Changes</span>

          </a></li>

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

          <span class="en">Localization</span>

        </a></li>

      <li class="nav-section">

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/resources/available-resources.html">

            <span class="en">Resource Types</span>

          </a></div>

        <ul>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/animation-resource.html">Animation</a></li>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/color-list-resource.html">Color State List</a></li>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/drawable-resource.html">Drawable</a></li>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/layout-resource.html">Layout</a></li>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/menu-resource.html">Menu</a></li>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/string-resource.html">String</a></li>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/style-resource.html">Style</a></li>

          <li><a href="<?cs var:toroot ?>guide/topics/resources/more-resources.html">More Types</a></li>

        </ul>

      </li>

      </li><!-- end of resource types -->

    </ul>

  </li><!-- end of app resources -->







  <li class="nav-section">

  <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/manifest/manifest-intro.html">

          <span class="en">Android Manifest</span>

      <span class="en">App Manifest</span>

    </a></div>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/topics/manifest/action-element.html">&lt;action&gt;</a></li>
@@ -130,8 +184,7 @@ 
    </ul>

  </li><!-- end of the manifest file -->



    </ul>

  </li>





  <li class="nav-section">

    <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/ui/index.html">
@@ -259,44 +312,6 @@ 
    </ul>

  </li><!-- end of User Interface -->



    <li class="nav-section">

      <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/resources/index.html">

           <span class="en">App Resources</span>

         </a></div>

      <ul>

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

            <span class="en">Overview</span>

          </a></li>

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

            <span class="en">Providing Resources</span>

          </a></li>

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

            <span class="en">Accessing Resources</span>

          </a></li>

        <li><a href="<?cs var:toroot ?>guide/topics/resources/runtime-changes.html">

              <span class="en">Handling Runtime Changes</span>

            </a></li>

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

            <span class="en">Localization</span>

          </a></li>

        <li class="nav-section">

          <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/resources/available-resources.html">

              <span class="en">Resource Types</span>

            </a></div>

          <ul>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/animation-resource.html">Animation</a></li>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/color-list-resource.html">Color State List</a></li>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/drawable-resource.html">Drawable</a></li>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/layout-resource.html">Layout</a></li>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/menu-resource.html">Menu</a></li>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/string-resource.html">String</a></li>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/style-resource.html">Style</a></li>

            <li><a href="<?cs var:toroot ?>guide/topics/resources/more-resources.html">More Types</a></li>

          </ul>

        </li><!-- end of resource types -->

      </ul>

    </li><!-- end of app resources -->



   <li class="nav-section">

      <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/graphics/index.html">

          <span class="en">Animation and Graphics</span>
@@ -527,9 +542,6 @@ 
      <span class="zh-tw" style="display:none">最佳實務</span>

    </div></a>

    <ul>

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

            <span class="en">Compatibility</span>

          </a></li>

      <li class="nav-section">

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/practices/screens_support.html">

          <span class="en">Supporting Multiple Screens</span>
@@ -550,74 +562,7 @@ 
    </ul>

  </li>



      <!-- this needs to move

      <li class="nav-section">

        <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/practices/ui_guidelines/index.html">

               <span class="en">UI Guidelines</span>

             </a></div>

        <ul>

          <li class="nav-section">

            <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/practices/ui_guidelines/icon_design.html">

                   <span class="en">Icon Design</span>

                 </a></div>

            <ul>

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

                    <span class="en">Launcher Icons</span>

                  </a></li>

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

                    <span class="en">Menu Icons</span>

                  </a></li>

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

                    <span class="en">Action Bar Icons</span>

                  </a></li>

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

                    <span class="en">Status Bar Icons</span>

                  </a></li>

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

                    <span class="en">Tab Icons</span>

                  </a></li>

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

                    <span class="en">Dialog Icons</span>

                  </a></li>

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

                    <span class="en">List View Icons</span>

                  </a></li>

            </ul>

          </li>

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

                <span class="en">App Widget Design</span>

              </a></div>

          </li>

        </ul>

      </li>

        </ul> -->



<!-- Remove

  <li class="nav-section">

    <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/appendix/index.html">

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

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

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

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

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

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

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

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

      </a></div>

    <ul>

      <li><a href="<?cs var:toroot ?>guide/appendix/g-app-intents.html">

            <span class="en">Intents List: Google Apps</span>

          </a></li>





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

            <span class="en">Glossary</span>

          </a></li>

    </ul>

  </li>



</li>

-->

</ul>

docs/html/guide/index.jd

0 → 100644
+75 −0
Original line number Diff line number Diff line 
page.title=Introduction to Android



@jd:body





<div class="sidebox" style="width:220px"><!-- width to match col-4 below -->

<p>To learn how apps work, start with

<a href="{@docRoot}guide/components/fundamentals.html">App Fundamentals</a>.</p>

<p>To begin coding right away, read <a

href="{@docRoot}training/basics/firstapp/index.html">Building Your First App</a>.</p>

</div>



<p>Android provides a rich application framework that allows you to build innovative apps and games

for mobile devices in a Java language environment. The documents listed in the left

navigation provide details about how to build apps using Android's various APIs.</p>



<p>If you're new to Android development, it's important that you understand

the following fundamental concepts about the Android app framework:</p>





<div class="landing-banner">



<div class="col-6">



<h4>Apps provide multiple entry points</h4>



<p>Android apps are built as a combination of distinct components that can be invoked

individually. For instance, an individual <em>activity</em> provides a single

screen for a user interface, and a <em>service</em> independently performs

work in the background.</p>



<p>From one component you can start another component using an <em>intent</em>. You can even start

a component in a different app, such an activity in a maps app to show an address. This model

provides multiple entry points for a single app and allows any app to behave as a user's "default"

for an action that other apps may invoke.</p>





<p><b>Learn more:</b></p>

<ul class="nolist">

<li><a href="{@docRoot}guide/components/fundamentals.html">App Fundamentals</a>

<li><a href="{@docRoot}guide/components/intents-filters.html">Intents and Intent Filters</a>

<li><a href="{@docRoot}guide/components/activities.html">Activities</a>

</ul>



</div>





<div class="col-6">



<h4>Apps adapt to different devices</h4>



<p>Android provides an adaptive app framework that allows you to provide unique resources

for different device configurations. For example, you can create different XML

layout files for different screen sizes and the system

determines which layout to apply based on the current device's screen size.</p>



<p>You can query the availability of device features at runtime if any app features require

specific hardware such as a camera. If necessary, you can also declare features your app requires

so app markets such as Google Play Store do not allow installation on devices that do not support

that feature.</p>





<p><b>Learn more:</b></p>

<ul class="nolist">

<li><a href="{@docRoot}guide/practices/compatibility.html">Device Compatibility</a>

<li><a href="{@docRoot}guide/topics/resources/overview.html">Resources Overview</a>

<li><a href="{@docRoot}guide/topics/ui/overview.html">User Interface Overview</a>

</ul>



</div>



</div><!-- end landing-banner -->

docs/html/guide/practices/compatibility.jd

+285 −200

File changed.

Preview size limit exceeded, changes collapsed.