Browse files

Website updates.

  • Loading branch information...
1 parent 51ee9b1 commit d82095fc273e778ed17c40d1239e5b3e953c7589 @JakeWharton committed Oct 7, 2012
Showing with 28 additions and 83 deletions.
  1. +3 −1 website/download.html
  2. +3 −3 website/index.html
  3. +0 −68 website/migration.html
  4. +17 −9 website/samples.html
  5. +5 −1 website/support.html
  6. +0 −1 website/usage.html
@@ -99,10 +99,12 @@
<dt class="normal">(loading)</dt>
- <h3>Third-Party Plugins</h3>
+ <h3>Third-Party Tools</h3>
<dl id="third-party">
<dt class="normal"><a href="">RoboGuice-Sherlock</a> &mdash; Roberto Tyley</dt>
<dd class="plugin">Base activities and base fragments which allow for easy use of RoboGuice and ActionBarSherlock together.</dd>
+ <dt class="normal"><a href="">Action Bar Style Generator</a> &mdash; Jeff Gilfelt</dt>
+ <dd class="plugin">Allows you to easily create a simple, attractive and seamless custom action bar style for your Android application. It will generate all necessary nine patch assets plus associated XML drawables and styles which you can copy straight into your project.</dd>
<div class="fourth last">
@@ -50,7 +50,7 @@
<div class="row">
<div class="half" id="feature">
<p id="header"><a class="img" href="index.html"><img src="static/logo.png" alt="Home"/></a></p>
- <p class="lead">ActionBarSherlock is an extension of the <a href="">compatibility library</a> designed to facilitate the use of the action bar design pattern across all versions of Android with a single API.</p>
+ <p class="lead">ActionBarSherlock is an extension of the <a href="">support library</a> designed to facilitate the use of the action bar design pattern across all versions of Android with a single API.</p>
<div id="sherlock"><a href="merch-and-donations.html"><img src="static/mascot.png" alt="Donations &amp; Merhandise" title="Buy me on a shirt!"/></a></div>
<p>The library will automatically use the native action bar when appropriate or will automatically wrap a custom implementation around your layouts. This allows you to easily develop an application with an action bar for every version of Android from 2.x and up.</p>
<div id="download">
@@ -104,8 +104,8 @@
<div class="half app">
<img src="static/apps/com.squareup.cardcase.png"/>
<div class="info">
- <h4>Pay with Square</h4>
- <p class="desc">Pay with your name using Square. Leave your wallet at home and simply give your name at checkout. Find businesses you love, share favorites and be rewarded.</p>
+ <h4>Square Wallet</h4>
+ <p class="desc">Fumbling for cash or plastic is a thing of the past. With Square Wallet, you just say your name to pay. Square Wallet also helps you discover nearby merchants and earn rewards.</p>
<p class="links"><a href="">View on Play Store</a></p>
@@ -1,68 +0,0 @@
-title: Migration Guide
-layout: default
-<div class="row">
- <div class="three-fourths">
- <h1>Migrating From Version 3.x to Version 4.0</h1>
- <p>The migration path between ActionBarSherlock version 3 and version 4 is very straightforward and can be accomplished in four distinct steps: activities/fragments, imports, methods, and themes. Finally we'll found up some common 'gotchas' that detail differences in interaction between the two versions.</p>
- <h2>Activites / Fragments</h2>
- <p>All of the activities in this version are now prefixed with 'Sherlock'. Each one is named after the type of framework activity that it extends. You should be able to update the base activity of all your classes by only adding the prefix.</p>
- <ul>
- <li><code>SherlockActivity</code> extends <code>Activity</code></li>
- <li><code>SherlockListActivity</code> extends <code>ListActivity</code></li>
- <li><code>SherlockFragmentActivity</code> extends <code>FragmentActivity</code></li>
- </ul>
- <p>All of these classes are in the <code></code> package.</p>
- <p>When using <code>SherlockFragmentActivity</code> you should also use the 'Sherlock'-prefixed fragment classes which follow the same naming rules (e.g., <code>SherlockFragment</code>, <code>SherlockListFragment</code>).</p>
- <h2>Imports</h2>
- <p>Since the library no longer is tightly coupled with the Android support library the package has changed from being in <code></code> to a much more appropriate <code>com.actionbarsherlock</code>.</p>
- <p>Because of this change, you will need to update all of your Sherlock-related imports in every class. Some of the key offenders are:</p>
- <ul>
- <li><code>com.actionbarsherlock.view.Menu</code></li>
- <li><code>com.actionbarsherlock.view.MenuItem</code></li>
- <li><code>com.actionbarsherlock.view.MenuInflater</code></li>
- <li><code>com.actionbarsherlock.view.Window</code></li>
- <li><code></code></li>
- </ul>
- <h2>Methods</h2>
- <p>Very few APIs have actually changed between versions. There are only two which you should be aware of:</p>
- <ul>
- <li><code>getSherlockActivity()</code> in any base fragment. This returns an instance of you activity that has already been cast to <code>SherlockFragmentActivity</code>.
- <li><code>getSherlock()</code> in any base activity. This will allow access to the <code>ActionBarSherlock</code> interface which allows for interaction with all of the features of the library. Normally you would not need access to this unless you want to programmatically set the activity's UI options.</li>
- </ul>
- <h2>Themes</h2>
- <p>Theming now more closely mirrors that of the native action bar and it should be much easier to now create them.</p>
- <p>Updating your old themes consists of moving any 'ab'-prefixed theme attributes to the action bar style and any 'am'-prefixed theme attributes to the action mode style.</p>
- <p>Themes must now also mirror their attributes to contain both the attributes with the 'android' namespace and ones without. The easiest way to show this comes from the 'Styled' example in the demos sample:</p>
- <pre>&lt;style name="Theme.Styled" parent="Theme.Sherlock.Light.DarkActionBar">
- &lt;item name="actionBarStyle">@style/Widget.Styled.ActionBar&lt;/item>
- &lt;item name="android:actionBarStyle">@style/Widget.Styled.ActionBar&lt;/item>
-&lt;style name="Widget.Styled.ActionBar" parent="Widget.Sherlock.Light.ActionBar.Solid.Inverse">
- &lt;item name="background">@drawable/bg_striped&lt;/item>
- &lt;item name="android:background">@drawable/bg_striped&lt;/item>
- &lt;item name="backgroundSplit">@drawable/bg_striped_split&lt;/item>
- &lt;item name="android:backgroundSplit">@drawable/bg_striped_split&lt;/item>
- <h2>Gotchas</h2>
- <ul>
- <li>If you application targets API 14 or newer in your <code>AndroidManifest.xml</code> the home icon will automatically be disabled. You can re-enable it to register click events by calling <a href=""><code>setHomeButtonEnabled(true)</code></a>. As always, the callback will have an ID of <code></code>.</li>
- <li>If you are using list navigation pay special attention to the 'List Navigation' example in the demos sample for direction on proper use. You need to use the library-provided layouts for both the item view and dropdown view as well as use the themed context from the action bar.</li>
- </ul>
- </div>
- <div class="fourth last">
- <h1>Learning By Example</h1>
- <p>Since there is only so much that a guide like this can convey it is strongly recommended that you study the source code to the sample applications. They have been engineered to showcase all of the features of the action bar and their correct usage.</p>
- <p>The samples are included in your library download in the <code>samples/</code> folder. You can also always find them by going to the <a href="">repository</a> directly.</p>
- <p>If you have any ideas for additional samples please <a href="support.html">contact Jake Wharton</a> or send a pull request to the <code>dev</code> branch.</p>
- </div>
@@ -7,32 +7,40 @@
<div class="three-fourths">
<h1>Library Samples</h1>
<p>The library comes with three samples, each of which demonstrate a different use case of ActionBarSherlock.</p>
- <p>A compiled <code>.apk</code> for each sample can be downloaded under the &quot;Sample Applications&quot; section of the <a href="download.html">download page</a>. You can obtain the source code for each in the <a href=""><code>samples/</code> directory</a> of the repository.</p>
+ <p>A compiled <code>.apk</code> for the samples can be downloaded under the &quot;Sample Applications&quot; section of the <a href="download.html">download page</a>. You can obtain the source code for each in the <a href=""><code>samples/</code> directory</a> of the repository.</p>
<p>The demo sample is a showcase of the functionality of the library and its action bar. There is an example for nearly every major feature of the library and you should refer to the source code for each activity for the proper way to use each.</p>
- <p><em>Screenshots coming soon.</em></p>
<p>This sample is simply the 'API Demos' sample from the Android support library ported to use <code>SherlockFragmentActivity</code> and <code>SherlockFragment</code>. It should provide a good idea of how these two classes are used to replace <code>FragmentActivity</code> and <code>Fragment</code>.</p>
- <p><em>Screenshots coming soon.</em></p>
<p>A port of one of the RoboGuice sample applications which shows how you can combine two libraries which require the use of base activities.</p>
- <p><em>Screenshots coming soon.</em></p>
+ <h3>Styled</h3>
+ <p>This sample is adapted from a blog post by Nick Butcher which demonstrates how to style various action bar components. While originally targetted at Honeycomb tablets, this sample still provides a good starter for styling.</p>
+ <h3>Known Bugs</h3>
+ <p>Unlike the others, this sample application's sole purpose it to demonstrate known bugs with the library. These oftentimes will be framework-related which need fixed in Android before they can be fixed in the library.</p>
<div class="fourth last">
<h1>Open-Source Examples</h1>
<p>The following are open-source applications which implement ActionBarSherlock in an exemplary fashion. These should provide a more realistic view of what implementation is like provide solutions for common implementation problems.</p>
+ <h3>GitHub Mobile</h3>
+ <p><em>GitHub is the best way to collaborate with others. Create, manage, and discuss issues and stay up to date with an integrated news feed for all your organizations, friends, and repositories.</em></p>
+ <p>The main GitHub app is a very clean and content-driven application which uses ActionBarSherlock as well as a lot of other open source libraries. It is a great reference for some best-practices.</p>
+ <p><a href="">Play Store</a> &middot; <a href="">GitHub</a></p>
<h3>SeriesGuide Show Manager</h3>
<p><em>&quot;Manage the progress of (re-)watching your favorite TV shows. Keep track of which episodes you still have to watch or which ones are upcoming.&quot;</em></p>
<p>The SeriesGuide application has implemented ActionBarSherlock for a very long time and coupled with heavy use of fragments has allowed for very dynamic layouts that scale well to every screen size.</p>
- <p><a href="">Play Market</a> &middot; <a href="">GitHub</a></p>
+ <p><a href="">Play Store</a> &middot; <a href="">GitHub</a></p>
- <h3>GitHub</h3>
- <p><em>&quot; is the most simple and beautiful way to track multiple sites and see live reporting on all of them from one convenient dashboard.&quot;</em></p>
- <p>The application by GitHub is a relatively simple application but shows how you can use ActionBarSherlock with simple styling to create a polished and unique look to your applications that matches your branding.</p>
- <p><a href="">Play Market</a> &middot; <a href="">GitHub</a></p>
+ <h3>Google I/O 2012</h3>
+ <p><em>The official Google I/O 2012 conference app.</em></p>
+ <p>Google's official scheduling application for the I/O developer conference. This application is great reference for some best practices and does an especially well job of showing how to provide layouts for all devices.</p>
+ <p><a href="">Play Store</a> &middot; <a href="">Google Code</a></p>
@@ -10,9 +10,13 @@
<p>Support for the implementation and development of ActionBarSherlock is available in the following places:</p>
<h3>Google Group</h3>
- <p>Post a message to the Google Group for my personal projects. This will allow myself as well as other users of the library to assist you. It will also serve as a catalog of previous questions and announcements which may be useful.</p>
+ <p>Post a message to the Google Group about ActionBarSherlock. This will allow myself as well as other users of the library to assist you. It will also serve as a catalog of previous questions and announcements which may be useful. Please DO NOT post general questions about using the action bar APIs.</p>
<p class="link"><a href=""></a></p>
+ <h3>StackOverflow</h3>
+ <p>Like Google Groups, this will allow fellow users to assist you solve your problem. This is also a more approriate place to post general questions about the action bar API.</p>
+ <p class="link"><a href=""></a></p>
<h3>GitHub Issues</h3>
<p>If you have found a bug or want to suggest a new feature then you can create an issue on the GitHub project.</p>
<p class="link"><a href=""></a></p>
@@ -25,7 +25,6 @@
<div class="three-fourths">
<p>Sticking with the theme of the official compatability library, ActionBarSherlock aims to allow the use of the action bar design pattern by mimicking the experience that would be found natively on Android Ice Cream Sandwich with as little effort as required.</p>
- <p><strong>Are you migrating an application from version 3.x to 4.x?</strong> Check out the <a href="migration.html">migration guide</a> for detailed steps that will get your app up and running with the new version.</p>
<p>Due to its use of the native action bar and its related classes on Ice Cream Sandwich, the library requires that both it and your project are compiled with Android 4.0 or newer. The project also requires that you are compiling with JDK 1.6 in both your editor and any build systems that you may be using.</p>

0 comments on commit d82095f

Please sign in to comment.