Skip to content
This repository
Browse code

Website at Mon Oct 7 00:13:29 PDT 2013

  • Loading branch information...
commit b80a985d738bbad53ecda6183ae25a9bc179add4 1 parent eebc26b
Jake Wharton authored October 07, 2013
68  development.html
... ...
@@ -1,35 +1,35 @@
1  
----
2  
-title: Development
3  
-layout: default
4  
----
5  
-
6  
-<div class="row">
7  
-	<div class="three-fourths">
8  
-		<h1>Development</h1>
9  
-		<p>The ActionBarSherlock library along with its plugins and sample applications are all built using Apache Maven. Maven will automate the process of compiling and assembling the <code>apklib</code>, <code>jar</code>s, and <code>apk</code>s for each module.</p>
10  
-		<p>Using Maven is <strong>NOT</strong> a requirement for contributing to development. It is merely used for automated testing and releasing of the libary and its sample applications.</p>
11  
-
12  
-		<h3 id="prerequisites">Prerequisites</h3>
13  
-		<p>Maven compilation requires that you have the <code>ANDROID_HOME</code> environment variable defined as the path to your Android SDK directory.</p>
14  
-		<p>For example, the following line is in my <code>~/.bash_profile</code> which sets this variable:</p>
15  
-		<pre>export ANDROID_HOME=/home/jake/vendor/android_sdk/</pre>
16  
-
17  
-		<h3 id="compiling">Compiling</h3>
18  
-		<p>Once the prerequisites have been successfully installed, building is as easy as running <code>mvn clean package</code>. The <code>apklib</code> for the library will be located in the <code>actionbarsherlock/target/</code> folder.</p>
19  
-		<p>You can find a <code>jar</code> for each plugin in its respective <code>target/</code> folder. The <code>apk</code>s for each of the samples are their respective <code>target/</code> folders as well.</p>
20  
-
21  
-		<h3 id="ide">IDE</h3>
22  
-		<p>Even though the project uses Maven, each folder within the repository still maintains the standard Android project layout. By specifying the desired folder as an existing source for a new Android project, you should be able to successfully import the sources.</p>
23  
-		<p>The library should be created as a project first. Any plugins and/or sample applications you also wish to create projects for can then be created.</p>
24  
-		<p>If your IDE supports Maven you can point it at the parent <code>pom.xml</code> file in the root of the repository which will load all of the modules automatically.</p>
25  
-
26  
-		<h3 id="codestyle">Code Style</h3>
27  
-		<p>Since a large portion of the source code is ported from the Android Open Source Project its conventions are followed in ActionBarSherlock. Detailed information can be found on <a href="http://s.android.com/source/code-style.html">the AOSP Code Guidelines</a> page.</p>
28  
-	</div>
29  
-	<div class="fourth last">
30  
-		<h1>Getting The Code</h1>
31  
-		<p>The source code repository is hosted on GitHub at <a href="https://github.com/JakeWharton/ActionBarSherlock">JakeWharton/ActionBarSherlock</a>.</p>
32  
-		<p>The GitHub project is also the location of <a href="https://github.com/JakeWharton/ActionBarSherlock/issues">the issue tracker</a> as well as the source code to this website.</p>
33  
-		<p class="centered"><a class="img" href="https://github.com/JakeWharton/ActionBarSherlock"><img src="static/octocat.png" alt="View project on GitHub"/></a></p>
34  
-	</div>
  1
+---
  2
+title: Development
  3
+layout: default
  4
+---
  5
+
  6
+<div class="row">
  7
+	<div class="three-fourths">
  8
+		<h1>Development</h1>
  9
+		<p>The ActionBarSherlock library along with its plugins and sample applications are all built using Apache Maven. Maven will automate the process of compiling and assembling the <code>apklib</code>, <code>jar</code>s, and <code>apk</code>s for each module.</p>
  10
+		<p>Using Maven is <strong>NOT</strong> a requirement for contributing to development. It is merely used for automated testing and releasing of the libary and its sample applications.</p>
  11
+
  12
+		<h3 id="prerequisites">Prerequisites</h3>
  13
+		<p>Maven compilation requires that you have the <code>ANDROID_HOME</code> environment variable defined as the path to your Android SDK directory.</p>
  14
+		<p>For example, the following line is in my <code>~/.bash_profile</code> which sets this variable:</p>
  15
+		<pre>export ANDROID_HOME=/home/jake/vendor/android_sdk/</pre>
  16
+
  17
+		<h3 id="compiling">Compiling</h3>
  18
+		<p>Once the prerequisites have been successfully installed, building is as easy as running <code>mvn clean package</code>. The <code>apklib</code> for the library will be located in the <code>actionbarsherlock/target/</code> folder.</p>
  19
+		<p>You can find a <code>jar</code> for each plugin in its respective <code>target/</code> folder. The <code>apk</code>s for each of the samples are their respective <code>target/</code> folders as well.</p>
  20
+
  21
+		<h3 id="ide">IDE</h3>
  22
+		<p>Even though the project uses Maven, each folder within the repository still maintains the standard Android project layout. By specifying the desired folder as an existing source for a new Android project, you should be able to successfully import the sources.</p>
  23
+		<p>The library should be created as a project first. Any plugins and/or sample applications you also wish to create projects for can then be created.</p>
  24
+		<p>If your IDE supports Maven you can point it at the parent <code>pom.xml</code> file in the root of the repository which will load all of the modules automatically.</p>
  25
+
  26
+		<h3 id="codestyle">Code Style</h3>
  27
+		<p>Since a large portion of the source code is ported from the Android Open Source Project its conventions are followed in ActionBarSherlock. Detailed information can be found on <a href="http://s.android.com/source/code-style.html">the AOSP Code Guidelines</a> page.</p>
  28
+	</div>
  29
+	<div class="fourth last">
  30
+		<h1>Getting The Code</h1>
  31
+		<p>The source code repository is hosted on GitHub at <a href="https://github.com/JakeWharton/ActionBarSherlock">JakeWharton/ActionBarSherlock</a>.</p>
  32
+		<p>The GitHub project is also the location of <a href="https://github.com/JakeWharton/ActionBarSherlock/issues">the issue tracker</a> as well as the source code to this website.</p>
  33
+		<p class="centered"><a class="img" href="https://github.com/JakeWharton/ActionBarSherlock"><img src="static/octocat.png" alt="View project on GitHub"/></a></p>
  34
+	</div>
35 35
 </div>
234  download.html
... ...
@@ -1,117 +1,117 @@
1  
----
2  
-title: Download
3  
-layout: default
4  
----
5  
-
6  
-<script type="text/javascript">
7  
-$(function() {
8  
-	$.getJSON('https://api.github.com/repos/JakeWharton/ActionBarSherlock/tags?callback=?', function(response) {
9  
-		var meta = response.meta
10  
-		  , data = response.data
11  
-		;
12  
-
13  
-		data.sort(function(o1, o2) {
14  
-			return (o1.name > o2.name) ? -1 : 1;
15  
-		});
16  
-
17  
-		var last = data[0];
18  
-		var lastSha = last.commit.sha;
19  
-		var lastDate = $('#latest-date').html('<em>Date unavailable</em>');
20  
-		$('.latest-version').html(last.name);
21  
-		$('#latest-zip').attr('href', last.zipball_url);
22  
-		$('#latest-tarball').attr('href', last.tarball_url);
23  
-
24  
-		var previous = $('#previous-releases').empty();
25  
-		$.each(data, function(index) {
26  
-			previous.append(
27  
-				$('<dt>Version ' + this.name + '<span class="normal"> &mdash; <em id="' + this.commit.sha + '">Date unavailable</em></span></dt>'),
28  
-				$('<dd><a class="img" href="' + this.zipball_url + '">Zip</a> &middot; <a class="img" href="' + this.tarball_url + '">Tarball</a></dd>')
29  
-			);
30  
-			$.getJSON(this.commit.url + '?callback=?', function(inner) {
31  
-				var d = new Date(inner.data.commit.author.date);
32  
-				var month = d.getMonth() + 1;
33  
-				if (month < 10) {
34  
-					month = '0' + month;
35  
-				}
36  
-				var day = d.getDate();
37  
-				if (day < 10) {
38  
-					day = '0' + day;
39  
-				}
40  
-				var date = d.getFullYear() + '-' + month + '-' + day;
41  
-				$('#' + inner.data.sha).html(date);
42  
-				if (inner.data.sha === lastSha) {
43  
-					lastDate.html(date);
44  
-				}
45  
-			});
46  
-
47  
-			//Only most recent 10 tags
48  
-			if (index == 9) {
49  
-				return false;
50  
-			}
51  
-		});
52  
-	});
53  
-
54  
-	$.getJSON('https://api.github.com/repos/JakeWharton/ActionBarSherlock/downloads?callback=?', function(response) {
55  
-		var meta = response.meta
56  
-		  , data = response.data
57  
-		;
58  
-
59  
-		var samples = $('#sample-apps').empty();
60  
-		$.each(data, function() {
61  
-			if (/apk$/.test(this.html_url)) {
62  
-				samples.append(
63  
-					$('<dt class="normal"/>').html(this.description.substring(0, 8) === "Sample: " ? this.description.substring(8) : this.description),
64  
-					$('<dd class="sample-app"/>').append(
65  
-						$('<a/>').attr('href', this.html_url).html('APK'),
66  
-						' &middot; ',
67  
-						$('<a/>').attr('href', 'http://chart.apis.google.com/chart?chs=545x545&cht=qr&chl=' + this.html_url + '&.png').html('QR Code').colorbox()
68  
-					)
69  
-				);
70  
-			}/* else if (/jar$/.test(this.html_url)) {
71  
-				plugins.append(
72  
-					$('<dt class="normal"/>').html(this.description.substring(0, 26) === "ActionBarSherlock Plugin: " ? this.description.substring(26) : this.description),
73  
-					$('<dd class="plugin"/>').append(
74  
-						$('<a/>').attr('href', this.html_url).html('JAR')
75  
-					)
76  
-				);
77  
-			}*/
78  
-		});
79  
-	});
80  
-});
81  
-</script>
82  
-
83  
-<div class="row">
84  
-	<div class="three-fourths">
85  
-		<h1>Download</h1>
86  
-		<p><strong>Version <span class="latest-version">(loading)</span></strong> &mdash; <span id="latest-date">(loading)</span> (<a id="changelog" href="https://github.com/JakeWharton/ActionBarSherlock/tree/master/CHANGELOG.md#readme">change log</a>)</p>
87  
-		<p><a class="img dl" id="latest-zip" href="https://github.com/JakeWharton/ActionBarSherlock/releases"><img src="static/down_grey.png" alt="Zip"/> Download .zip</a></p>
88  
-		<p><a class="img dl" id="latest-tarball" href="https://github.com/JakeWharton/ActionBarSherlock/releases"><img src="static/down_grey.png" alt="Tarball"/> Download .tgz</a></p>
89  
-		<!-- Download icon by Ddate Kaspar / Franziska Sponsel -->
90  
-
91  
-		<h3>Plugins</h3>
92  
-		<dl id="plugins">
93  
-			<dt class="normal"><a href="https://github.com/JakeWharton/ActionBarSherlock-Plugin-Maps/downloads">Google Maps</a></dt>
94  
-			<dd class="plugin">Base activity which extends from <code>MapActivity</code>.</dd>
95  
-		</dl>
96  
-
97  
-		<h3>Sample Applications</h3>
98  
-		<dl id="sample-apps">
99  
-			<dt class="normal">(loading)</dt>
100  
-		</dl>
101  
-
102  
-		<h3>Third-Party Tools</h3>
103  
-		<dl id="third-party">
104  
-			<dt class="normal"><a href="https://github.com/rtyley/roboguice-sherlock">RoboGuice-Sherlock</a> &mdash; Roberto Tyley</dt>
105  
-			<dd class="plugin">Base activities and base fragments which allow for easy use of RoboGuice and ActionBarSherlock together.</dd>
106  
-			<dt class="normal"><a href="http://jgilfelt.github.com/android-actionbarstylegenerator/">Action Bar Style Generator</a> &mdash; Jeff Gilfelt</dt>
107  
-			<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>
108  
-		</dl>
109  
-	</div>
110  
-	<div class="fourth last">
111  
-		<h1>Release History</h1>
112  
-		<dl id="previous-releases">
113  
-			<dt class="normal">(loading)</dt>
114  
-		</dl>
115  
-		<p><a href="https://github.com/JakeWharton/ActionBarSherlock/releases">View all &raquo;</a></p>
116  
-	</div>
117  
-</div>
  1
+---
  2
+title: Download
  3
+layout: default
  4
+---
  5
+
  6
+<script type="text/javascript">
  7
+$(function() {
  8
+	$.getJSON('https://api.github.com/repos/JakeWharton/ActionBarSherlock/tags?callback=?', function(response) {
  9
+		var meta = response.meta
  10
+		  , data = response.data
  11
+		;
  12
+
  13
+		data.sort(function(o1, o2) {
  14
+			return (o1.name > o2.name) ? -1 : 1;
  15
+		});
  16
+
  17
+		var last = data[0];
  18
+		var lastSha = last.commit.sha;
  19
+		var lastDate = $('#latest-date').html('<em>Date unavailable</em>');
  20
+		$('.latest-version').html(last.name);
  21
+		$('#latest-zip').attr('href', last.zipball_url);
  22
+		$('#latest-tarball').attr('href', last.tarball_url);
  23
+
  24
+		var previous = $('#previous-releases').empty();
  25
+		$.each(data, function(index) {
  26
+			previous.append(
  27
+				$('<dt>Version ' + this.name + '<span class="normal"> &mdash; <em id="' + this.commit.sha + '">Date unavailable</em></span></dt>'),
  28
+				$('<dd><a class="img" href="' + this.zipball_url + '">Zip</a> &middot; <a class="img" href="' + this.tarball_url + '">Tarball</a></dd>')
  29
+			);
  30
+			$.getJSON(this.commit.url + '?callback=?', function(inner) {
  31
+				var d = new Date(inner.data.commit.author.date);
  32
+				var month = d.getMonth() + 1;
  33
+				if (month < 10) {
  34
+					month = '0' + month;
  35
+				}
  36
+				var day = d.getDate();
  37
+				if (day < 10) {
  38
+					day = '0' + day;
  39
+				}
  40
+				var date = d.getFullYear() + '-' + month + '-' + day;
  41
+				$('#' + inner.data.sha).html(date);
  42
+				if (inner.data.sha === lastSha) {
  43
+					lastDate.html(date);
  44
+				}
  45
+			});
  46
+
  47
+			//Only most recent 10 tags
  48
+			if (index == 9) {
  49
+				return false;
  50
+			}
  51
+		});
  52
+	});
  53
+
  54
+	$.getJSON('https://api.github.com/repos/JakeWharton/ActionBarSherlock/downloads?callback=?', function(response) {
  55
+		var meta = response.meta
  56
+		  , data = response.data
  57
+		;
  58
+
  59
+		var samples = $('#sample-apps').empty();
  60
+		$.each(data, function() {
  61
+			if (/apk$/.test(this.html_url)) {
  62
+				samples.append(
  63
+					$('<dt class="normal"/>').html(this.description.substring(0, 8) === "Sample: " ? this.description.substring(8) : this.description),
  64
+					$('<dd class="sample-app"/>').append(
  65
+						$('<a/>').attr('href', this.html_url).html('APK'),
  66
+						' &middot; ',
  67
+						$('<a/>').attr('href', 'http://chart.apis.google.com/chart?chs=545x545&cht=qr&chl=' + this.html_url + '&.png').html('QR Code').colorbox()
  68
+					)
  69
+				);
  70
+			}/* else if (/jar$/.test(this.html_url)) {
  71
+				plugins.append(
  72
+					$('<dt class="normal"/>').html(this.description.substring(0, 26) === "ActionBarSherlock Plugin: " ? this.description.substring(26) : this.description),
  73
+					$('<dd class="plugin"/>').append(
  74
+						$('<a/>').attr('href', this.html_url).html('JAR')
  75
+					)
  76
+				);
  77
+			}*/
  78
+		});
  79
+	});
  80
+});
  81
+</script>
  82
+
  83
+<div class="row">
  84
+	<div class="three-fourths">
  85
+		<h1>Download</h1>
  86
+		<p><strong>Version <span class="latest-version">(loading)</span></strong> &mdash; <span id="latest-date">(loading)</span> (<a id="changelog" href="https://github.com/JakeWharton/ActionBarSherlock/tree/master/CHANGELOG.md#readme">change log</a>)</p>
  87
+		<p><a class="img dl" id="latest-zip" href="https://github.com/JakeWharton/ActionBarSherlock/releases"><img src="static/down_grey.png" alt="Zip"/> Download .zip</a></p>
  88
+		<p><a class="img dl" id="latest-tarball" href="https://github.com/JakeWharton/ActionBarSherlock/releases"><img src="static/down_grey.png" alt="Tarball"/> Download .tgz</a></p>
  89
+		<!-- Download icon by Ddate Kaspar / Franziska Sponsel -->
  90
+
  91
+		<h3>Plugins</h3>
  92
+		<dl id="plugins">
  93
+			<dt class="normal"><a href="https://github.com/JakeWharton/ActionBarSherlock-Plugin-Maps/downloads">Google Maps</a></dt>
  94
+			<dd class="plugin">Base activity which extends from <code>MapActivity</code>.</dd>
  95
+		</dl>
  96
+
  97
+		<h3>Sample Applications</h3>
  98
+		<dl id="sample-apps">
  99
+			<dt class="normal">(loading)</dt>
  100
+		</dl>
  101
+
  102
+		<h3>Third-Party Tools</h3>
  103
+		<dl id="third-party">
  104
+			<dt class="normal"><a href="https://github.com/rtyley/roboguice-sherlock">RoboGuice-Sherlock</a> &mdash; Roberto Tyley</dt>
  105
+			<dd class="plugin">Base activities and base fragments which allow for easy use of RoboGuice and ActionBarSherlock together.</dd>
  106
+			<dt class="normal"><a href="http://jgilfelt.github.com/android-actionbarstylegenerator/">Action Bar Style Generator</a> &mdash; Jeff Gilfelt</dt>
  107
+			<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>
  108
+		</dl>
  109
+	</div>
  110
+	<div class="fourth last">
  111
+		<h1>Release History</h1>
  112
+		<dl id="previous-releases">
  113
+			<dt class="normal">(loading)</dt>
  114
+		</dl>
  115
+		<p><a href="https://github.com/JakeWharton/ActionBarSherlock/releases">View all &raquo;</a></p>
  116
+	</div>
  117
+</div>
144  faq.html
... ...
@@ -1,72 +1,72 @@
1  
----
2  
-title: Merchandise and Donations
3  
-layout: default
4  
----
5  
-
6  
-
7  
-<div class="row">
8  
-	<div class="whole">
9  
-		<h1>Frequently Asked Questions</h1>
10  
-		<p>Have a question that is not listed on this page? See the &quot;Direct Contact&quot; section of the <a href="support.html">support page</a>.</p>
11  
-		<table id="faq-table">
12  
-			<tr>
13  
-				<th>Is there a video that will help me get started?</th>
14  
-				<td>
15  
-					<p>Yes there is! Graham Smith was kind enough to make this:</p>
16  
-					<iframe width="560" height="315" src="http://www.youtube.com/embed/4GJ6yY1lNNY" frameborder="0" allowfullscreen></iframe>
17  
-					<p><em>Note: The <code>library/</code> folder is now <code>actionbarsherlock/</code>.</em></p>
18  
-				</td>
19  
-			</tr>
20  
-			<tr>
21  
-				<th>What action bar library is used on pre-4.0 devices?</th>
22  
-				<td>The widget is a custom implementation that was purpose-built to mimic the API, functionality, and look of the native action bar on 4.0+ devices. It is primarily comprised of the sources from the Android Open Source Project with heavy modifications to ensure that it works on the earlier API levels.</td>
23  
-			</tr>
24  
-			<tr>
25  
-				<th>Why isn't the native action bar used on Android 3.x?</th>
26  
-				<td>The action bar on Android 3.x (also known as Honeycomb) does not implement all of the features of the one in Android 4.x (Ice Cream Sandwich). In order to provide a full action bar API on all platforms as well as unify the styling across all versions of Android the custom implementation is used.</p>
27  
-			</tr>
28  
-			<tr>
29  
-				<th>What API level should I compile with if I want to use the library?</th>
30  
-				<td>Use of this library requires that both it and your project are compiled with Android 4.0 (API 14) or newer.</td>
31  
-			</tr>
32  
-			<tr>
33  
-				<th>What API level should I target in my manifest when using the library?</th>
34  
-				<td>Targetting API level 11 or newer is required as it will cause Android to automatically add the native action bar when run on newer devices. Since you will be compiling against new APIs but your app will likely be run on devices with older versions of Android extra care must be taken to either avoid using or properly check and call any methods that were introduced after your minimum SDK version.</td>
35  
-			</tr>
36  
-			<tr>
37  
-				<th>Can you add functionality *X* to the action bar?</th>
38  
-				<td>As a general rule, no. If the native action bar on Android 3.0+ does not support it then it will not be supported by this library.</td>
39  
-			</tr>
40  
-			<tr>
41  
-				<th>Why is ActionBarSherlock a library project whereas the original compatibility library is only a <code>.jar</code>?</th>
42  
-				<td>The custom action bar implementation within ActionBarSherlock relies on styles, themes, layouts, and drawables in order to display properly. Due to the limitations of Android and <code>.jar</code> files, this currently can not be accomplished any other way.</td>
43  
-			</tr>
44  
-			<tr>
45  
-				<th>I found a bug, what should I do?</th>
46  
-				<td>See the <a href="support.html">support page</a> and create an issue on GitHub, post to the Google Group, or contact me directly. Or do all three! The worst thing you can do is to not report it. Please try to include as much information as possible in your report.</td>
47  
-			</tr>
48  
-			<tr>
49  
-				<th>Do I need to include the <code>.jar</code> file for the Android compatibility library when using ActionBarSherlock?</th>
50  
-				<td><strong>Yes.</strong> ActionBarSherlock is built as an extension of the Android compatibility library and requires that it be included.</td>
51  
-			</tr>
52  
-			<tr>
53  
-				<th>I get the following exception when using fragments: <em>&quot;Cannot interact with object designed for temporary instance passing.&quot;</em></th>
54  
-				<td>In order to provide the full ICS menu API the library provides its own fragment base classes. Like the activities, they are prefixed with 'Sherlock' and are provided for each of the fragment classes from the support library (e.g., <code>SherlockFragment</code>, <code>SherlockDialogFragment</code>).</td>
55  
-			</tr>
56  
-			<tr>
57  
-				<th>I use Proguard. Are there any lines I should include to ensure functionality of the library?</th>
58  
-				<td>
59  
-					<p>Add the following lines:</p>
60  
-					<code><pre>
61  
--keep class android.support.v4.app.** { *; }
62  
--keep interface android.support.v4.app.** { *; }
63  
--keep class com.actionbarsherlock.** { *; }
64  
--keep interface com.actionbarsherlock.** { *; }
65  
-
66  
--keepattributes *Annotation*
67  
-					</pre></code>
68  
-				</td>
69  
-			</tr>
70  
-		</table>
71  
-	</div>
72  
-</div>
  1
+---
  2
+title: Merchandise and Donations
  3
+layout: default
  4
+---
  5
+
  6
+
  7
+<div class="row">
  8
+	<div class="whole">
  9
+		<h1>Frequently Asked Questions</h1>
  10
+		<p>Have a question that is not listed on this page? See the &quot;Direct Contact&quot; section of the <a href="support.html">support page</a>.</p>
  11
+		<table id="faq-table">
  12
+			<tr>
  13
+				<th>Is there a video that will help me get started?</th>
  14
+				<td>
  15
+					<p>Yes there is! Graham Smith was kind enough to make this:</p>
  16
+					<iframe width="560" height="315" src="http://www.youtube.com/embed/4GJ6yY1lNNY" frameborder="0" allowfullscreen></iframe>
  17
+					<p><em>Note: The <code>library/</code> folder is now <code>actionbarsherlock/</code>.</em></p>
  18
+				</td>
  19
+			</tr>
  20
+			<tr>
  21
+				<th>What action bar library is used on pre-4.0 devices?</th>
  22
+				<td>The widget is a custom implementation that was purpose-built to mimic the API, functionality, and look of the native action bar on 4.0+ devices. It is primarily comprised of the sources from the Android Open Source Project with heavy modifications to ensure that it works on the earlier API levels.</td>
  23
+			</tr>
  24
+			<tr>
  25
+				<th>Why isn't the native action bar used on Android 3.x?</th>
  26
+				<td>The action bar on Android 3.x (also known as Honeycomb) does not implement all of the features of the one in Android 4.x (Ice Cream Sandwich). In order to provide a full action bar API on all platforms as well as unify the styling across all versions of Android the custom implementation is used.</p>
  27
+			</tr>
  28
+			<tr>
  29
+				<th>What API level should I compile with if I want to use the library?</th>
  30
+				<td>Use of this library requires that both it and your project are compiled with Android 4.0 (API 14) or newer.</td>
  31
+			</tr>
  32
+			<tr>
  33
+				<th>What API level should I target in my manifest when using the library?</th>
  34
+				<td>Targetting API level 11 or newer is required as it will cause Android to automatically add the native action bar when run on newer devices. Since you will be compiling against new APIs but your app will likely be run on devices with older versions of Android extra care must be taken to either avoid using or properly check and call any methods that were introduced after your minimum SDK version.</td>
  35
+			</tr>
  36
+			<tr>
  37
+				<th>Can you add functionality *X* to the action bar?</th>
  38
+				<td>As a general rule, no. If the native action bar on Android 3.0+ does not support it then it will not be supported by this library.</td>
  39
+			</tr>
  40
+			<tr>
  41
+				<th>Why is ActionBarSherlock a library project whereas the original compatibility library is only a <code>.jar</code>?</th>
  42
+				<td>The custom action bar implementation within ActionBarSherlock relies on styles, themes, layouts, and drawables in order to display properly. Due to the limitations of Android and <code>.jar</code> files, this currently can not be accomplished any other way.</td>
  43
+			</tr>
  44
+			<tr>
  45
+				<th>I found a bug, what should I do?</th>
  46
+				<td>See the <a href="support.html">support page</a> and create an issue on GitHub, post to the Google Group, or contact me directly. Or do all three! The worst thing you can do is to not report it. Please try to include as much information as possible in your report.</td>
  47
+			</tr>
  48
+			<tr>
  49
+				<th>Do I need to include the <code>.jar</code> file for the Android compatibility library when using ActionBarSherlock?</th>
  50
+				<td><strong>Yes.</strong> ActionBarSherlock is built as an extension of the Android compatibility library and requires that it be included.</td>
  51
+			</tr>
  52
+			<tr>
  53
+				<th>I get the following exception when using fragments: <em>&quot;Cannot interact with object designed for temporary instance passing.&quot;</em></th>
  54
+				<td>In order to provide the full ICS menu API the library provides its own fragment base classes. Like the activities, they are prefixed with 'Sherlock' and are provided for each of the fragment classes from the support library (e.g., <code>SherlockFragment</code>, <code>SherlockDialogFragment</code>).</td>
  55
+			</tr>
  56
+			<tr>
  57
+				<th>I use Proguard. Are there any lines I should include to ensure functionality of the library?</th>
  58
+				<td>
  59
+					<p>Add the following lines:</p>
  60
+					<code><pre>
  61
+-keep class android.support.v4.app.** { *; }
  62
+-keep interface android.support.v4.app.** { *; }
  63
+-keep class com.actionbarsherlock.** { *; }
  64
+-keep interface com.actionbarsherlock.** { *; }
  65
+
  66
+-keepattributes *Annotation*
  67
+					</pre></code>
  68
+				</td>
  69
+			</tr>
  70
+		</table>
  71
+	</div>
  72
+</div>
72  merch-and-donations.html
... ...
@@ -1,36 +1,36 @@
1  
----
2  
-title: Merchandise and Donations
3  
-layout: default
4  
----
5  
-
6  
-
7  
-<div class="row">
8  
-	<div class="half">
9  
-		<h1>Merchandise</h1>
10  
-		<p>Purchase merchandise containing the ActionBarSherlock mascot! A small portion of the proceeds will go to benefit development of the library.</p>
11  
-		<p class="centered"><a href="http://actionbarsherlock.spreadshirt.com">actionbarsherlock.spreadshirt.com</a></p>
12  
-		<p class="centered"><a href="http://actionbarsherlock.spreadshirt.com" class="img"><img src="static/merch.png" alt="Merchandise"/></a></p>
13  
-	</div>
14  
-	<div class="fourth">
15  
-		<h1>Flattr</h1>
16  
-		<p>The Flattr service is available for those users who would like to show a continued support of the project.</p>
17  
-		<p class="centered"><a class="FlattrButton" style="display:none;" href="http://actionbarsherlock.com"></a><noscript><a href="http://flattr.com/thing/320252/ActionBarSherlock" target="_blank"><img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" border="0" /></a></noscript></p>
18  
-		<p>For more information on how Flattr works, please <a href="https://flattr.com/">visit their website</a>.</p>
19  
-	</div>
20  
-	<div class="fourth last">
21  
-		<h1>PayPal</h1>
22  
-		<p>PayPal is available for one-time contributions of your choice.</p>
23  
-		<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
24  
-			<input type="hidden" name="cmd" value="_s-xclick">
25  
-			<input type="hidden" name="hosted_button_id" value="V6RUAWR9TLG2E">
26  
-			<p class="centered">
27  
-				<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
28  
-				<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
29  
-			</p>
30  
-		</form>
31  
-		<p>Due to the fees that PayPal charges, please donate no less than $1.</p>
32  
-	</div>
33  
-	<div class="half last">
34  
-		<p>Your monetary support is greatly appreciated and will be used toward the costs assocaited with developing this library (e.g., GitHub subscription, designer commisioning, etc.).</p>
35  
-	</div>
36  
-</div>
  1
+---
  2
+title: Merchandise and Donations
  3
+layout: default
  4
+---
  5
+
  6
+
  7
+<div class="row">
  8
+	<div class="half">
  9
+		<h1>Merchandise</h1>
  10
+		<p>Purchase merchandise containing the ActionBarSherlock mascot! A small portion of the proceeds will go to benefit development of the library.</p>
  11
+		<p class="centered"><a href="http://actionbarsherlock.spreadshirt.com">actionbarsherlock.spreadshirt.com</a></p>
  12
+		<p class="centered"><a href="http://actionbarsherlock.spreadshirt.com" class="img"><img src="static/merch.png" alt="Merchandise"/></a></p>
  13
+	</div>
  14
+	<div class="fourth">
  15
+		<h1>Flattr</h1>
  16
+		<p>The Flattr service is available for those users who would like to show a continued support of the project.</p>
  17
+		<p class="centered"><a class="FlattrButton" style="display:none;" href="http://actionbarsherlock.com"></a><noscript><a href="http://flattr.com/thing/320252/ActionBarSherlock" target="_blank"><img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" border="0" /></a></noscript></p>
  18
+		<p>For more information on how Flattr works, please <a href="https://flattr.com/">visit their website</a>.</p>
  19
+	</div>
  20
+	<div class="fourth last">
  21
+		<h1>PayPal</h1>
  22
+		<p>PayPal is available for one-time contributions of your choice.</p>
  23
+		<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
  24
+			<input type="hidden" name="cmd" value="_s-xclick">
  25
+			<input type="hidden" name="hosted_button_id" value="V6RUAWR9TLG2E">
  26
+			<p class="centered">
  27
+				<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
  28
+				<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
  29
+			</p>
  30
+		</form>
  31
+		<p>Due to the fees that PayPal charges, please donate no less than $1.</p>
  32
+	</div>
  33
+	<div class="half last">
  34
+		<p>Your monetary support is greatly appreciated and will be used toward the costs assocaited with developing this library (e.g., GitHub subscription, designer commisioning, etc.).</p>
  35
+	</div>
  36
+</div>
92  samples.html
... ...
@@ -1,46 +1,46 @@
1  
----
2  
-title: Samples
3  
-layout: default
4  
----
5  
-
6  
-<div class="row">
7  
-	<div class="three-fourths">
8  
-		<h1>Library Samples</h1>
9  
-		<p>The library comes with three samples, each of which demonstrate a different use case of ActionBarSherlock.</p>
10  
-		<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="https://github.com/JakeWharton/ActionBarSherlock/tree/master/actionbarsherlock-samples"><code>samples/</code> directory</a> of the repository.</p>
11  
-
12  
-		<h3>Demos</h3>
13  
-		<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>
14  
-
15  
-		<h3>Fragments</h3>
16  
-		<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>
17  
-
18  
-		<h3>RoboGuice</h3>
19  
-		<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>
20  
-
21  
-		<h3>Styled</h3>
22  
-		<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>
23  
-
24  
-		<h3>Known Bugs</h3>
25  
-		<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>
26  
-	</div>
27  
-	<div class="fourth last">
28  
-		<h1>Open-Source Examples</h1>
29  
-		<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>
30  
-
31  
-		<h3>GitHub Mobile</h3>
32  
-		<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>
33  
-		<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>
34  
-		<p><a href="https://play.google.com/store/apps/details?id=com.github.mobile">Play Store</a> &middot; <a href="https://github.com/github/android">GitHub</a></p>
35  
-
36  
-		<h3>SeriesGuide Show Manager</h3>
37  
-		<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>
38  
-		<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>
39  
-		<p><a href="https://market.android.com/details?id=com.battlelancer.seriesguide">Play Store</a> &middot; <a href="https://github.com/UweTrottmann/SeriesGuide">GitHub</a></p>
40  
-
41  
-		<h3>Google I/O 2012</h3>
42  
-		<p><em>The official Google I/O 2012 conference app.</em></p>
43  
-		<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>
44  
-		<p><a href="https://play.google.com/store/apps/details?id=com.google.android.apps.iosched">Play Store</a> &middot; <a href="http://code.google.com/p/iosched/">Google Code</a></p>
45  
-	</div>
46  
-</div>
  1
+---
  2
+title: Samples
  3
+layout: default
  4
+---
  5
+
  6
+<div class="row">
  7
+	<div class="three-fourths">
  8
+		<h1>Library Samples</h1>
  9
+		<p>The library comes with three samples, each of which demonstrate a different use case of ActionBarSherlock.</p>
  10
+		<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="https://github.com/JakeWharton/ActionBarSherlock/tree/master/actionbarsherlock-samples"><code>samples/</code> directory</a> of the repository.</p>
  11
+
  12
+		<h3>Demos</h3>
  13
+		<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>
  14
+
  15
+		<h3>Fragments</h3>
  16
+		<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>
  17
+
  18
+		<h3>RoboGuice</h3>
  19
+		<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>
  20
+
  21
+		<h3>Styled</h3>
  22
+		<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>
  23
+
  24
+		<h3>Known Bugs</h3>
  25
+		<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>
  26
+	</div>
  27
+	<div class="fourth last">
  28
+		<h1>Open-Source Examples</h1>
  29
+		<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>
  30
+
  31
+		<h3>GitHub Mobile</h3>
  32
+		<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>
  33
+		<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>
  34
+		<p><a href="https://play.google.com/store/apps/details?id=com.github.mobile">Play Store</a> &middot; <a href="https://github.com/github/android">GitHub</a></p>
  35
+
  36
+		<h3>SeriesGuide Show Manager</h3>
  37
+		<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>
  38
+		<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>
  39
+		<p><a href="https://market.android.com/details?id=com.battlelancer.seriesguide">Play Store</a> &middot; <a href="https://github.com/UweTrottmann/SeriesGuide">GitHub</a></p>
  40
+
  41
+		<h3>Google I/O 2012</h3>
  42
+		<p><em>The official Google I/O 2012 conference app.</em></p>
  43
+		<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>
  44
+		<p><a href="https://play.google.com/store/apps/details?id=com.google.android.apps.iosched">Play Store</a> &middot; <a href="http://code.google.com/p/iosched/">Google Code</a></p>
  45
+	</div>
  46
+</div>
2  static/css3-mediaqueries.js
@@ -776,4 +776,4 @@ document.execCommand("BackgroundImageCache",false,true);
776 776
 }
777 777
 catch(e){
778 778
 }
779  
-
  779
+
92  support.html
... ...
@@ -1,47 +1,47 @@
1  
----
2  
-title: Support
3  
-layout: default
4  
----
5  
-
6  
-
7  
-<div class="row">
8  
-	<div class="three-fourths">
9  
-		<h1>Support</h1>
10  
-		<p>Support for the implementation and development of ActionBarSherlock is available in the following places:</p>
11  
-
12  
-		<h3>Google Group</h3>
13  
-		<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>
14  
-		<p class="link"><a href="https://groups.google.com/group/actionbarsherlock">groups.google.com/group/actionbarsherlock</a></p>
15  
-
16  
-		<h3>StackOverflow</h3>
17  
-		<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>
18  
-		<p class="link"><a href="http://stackoverflow.com/tags/actionbarsherlock">stackoverflow.com/tags/actionbarsherlock</a></p>
19  
-
20  
-		<h3>GitHub Issues</h3>
21  
-		<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>
22  
-		<p class="link"><a href="https://github.com/JakeWharton/ActionBarSherlock/issues">github.com/JakeWharton/ActionBarSherlock/issues</a></p>
23  
-
24  
-		<h3>Direct Contact</h3>
25  
-		<p>You may also contact me directly if the above two options are not sufficient.</p>
26  
-		<ul>
27  
-			<li>Twitter: <a href="http://twitter.com/JakeWharton">@JakeWharton</a></li>
28  
-			<li>Google Plus: <a href="http://profiles.google.com/jakewharton">+JakeWharton</a></li>
29  
-			<li>IRC: <a href="irc://irc.freenode.net/android-dev">#android-dev on irc.freenode.net</a> (user <code>JakeWharton</code>)</li>
30  
-		</ul>
31  
-	</div>
32  
-	<div class="fourth last">
33  
-		<h1>...Of A Different Kind</h1>
34  
-		<p>If you are looking for ways to support the development and maintenance of this project there are various ways to contribute both directly and indirectly.</p>
35  
-		<dl>
36  
-			<dt>Code</dt>
37  
-			<dd>Contributions of code are the best way to show your support of the library. For more information see the <a href="development.html">development page</a>.</dd>
38  
-			<dt>Buy Merchandise</dt>
39  
-			<dd>An Android-themed mascot logo was commisioned for ActionBarSherlock and now you can wear it. The <a href="merch-and-donations.html">merchandise page</a> has all the details.</dd>
40  
-			<dt>Donations</dt>
41  
-			<dd>Monetary support is accepted via PayPal or Flattr from the <a href="merch-and-donations.html">donation page</a>.</dd>
42  
-			<dt>Be Social</dt>
43  
-			<dd>Educating other developers on the existence and advantages of this library is the quickest and easiest way to voice your support.</dd>
44  
-			<dd>Click the Google +1, Twitter, and/or Facebook links below to get started. Please also link to the site from blog posts and on StackOverflow answers.</dd>
45  
-		</dl>
46  
-	</div>
  1
+---
  2
+title: Support
  3
+layout: default
  4
+---
  5
+
  6
+
  7
+<div class="row">
  8
+	<div class="three-fourths">
  9
+		<h1>Support</h1>
  10
+		<p>Support for the implementation and development of ActionBarSherlock is available in the following places:</p>
  11
+
  12
+		<h3>Google Group</h3>
  13
+		<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>
  14
+		<p class="link"><a href="https://groups.google.com/group/actionbarsherlock">groups.google.com/group/actionbarsherlock</a></p>
  15
+
  16
+		<h3>StackOverflow</h3>
  17
+		<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>
  18
+		<p class="link"><a href="http://stackoverflow.com/tags/actionbarsherlock">stackoverflow.com/tags/actionbarsherlock</a></p>
  19
+
  20
+		<h3>GitHub Issues</h3>
  21
+		<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>
  22
+		<p class="link"><a href="https://github.com/JakeWharton/ActionBarSherlock/issues">github.com/JakeWharton/ActionBarSherlock/issues</a></p>
  23
+
  24
+		<h3>Direct Contact</h3>
  25
+		<p>You may also contact me directly if the above two options are not sufficient.</p>
  26
+		<ul>
  27
+			<li>Twitter: <a href="http://twitter.com/JakeWharton">@JakeWharton</a></li>
  28
+			<li>Google Plus: <a href="http://profiles.google.com/jakewharton">+JakeWharton</a></li>
  29
+			<li>IRC: <a href="irc://irc.freenode.net/android-dev">#android-dev on irc.freenode.net</a> (user <code>JakeWharton</code>)</li>
  30
+		</ul>
  31
+	</div>
  32
+	<div class="fourth last">
  33
+		<h1>...Of A Different Kind</h1>
  34
+		<p>If you are looking for ways to support the development and maintenance of this project there are various ways to contribute both directly and indirectly.</p>
  35
+		<dl>
  36
+			<dt>Code</dt>
  37
+			<dd>Contributions of code are the best way to show your support of the library. For more information see the <a href="development.html">development page</a>.</dd>
  38
+			<dt>Buy Merchandise</dt>
  39
+			<dd>An Android-themed mascot logo was commisioned for ActionBarSherlock and now you can wear it. The <a href="merch-and-donations.html">merchandise page</a> has all the details.</dd>
  40
+			<dt>Donations</dt>
  41
+			<dd>Monetary support is accepted via PayPal or Flattr from the <a href="merch-and-donations.html">donation page</a>.</dd>
  42
+			<dt>Be Social</dt>
  43
+			<dd>Educating other developers on the existence and advantages of this library is the quickest and easiest way to voice your support.</dd>
  44
+			<dd>Click the Google +1, Twitter, and/or Facebook links below to get started. Please also link to the site from blog posts and on StackOverflow answers.</dd>
  45
+		</dl>
  46
+	</div>
47 47
 </div>
66  theming.html
... ...
@@ -1,33 +1,33 @@
1  
----
2  
-title: Theming
3  
-layout: default
4  
----
5  
-
6  
-<div class="row">
7  
-	<div class="whole" id="theming">
8  
-		<h1>Theming</h1>
9  
-
10  
-		<p>Theming of the action bar to work on all devices is a very straightforward and simple process. You should follow the existing theming recommendations for <a href="http://android-developers.blogspot.com/2011/04/customizing-action-bar.html">customizing the native action bar</a> with some minor tweaks.</p>
11  
-		<p>An example of a customized action bar can be seen in the &ldquo;Styled&rdquo; example in the 'Demos' sample.</p>
12  
-
13  
-		<h3>Parent Themes</h3>
14  
-		<p>In order for the custom action bar implementation to function your application must use <code>Theme.Sherlock</code>, <code>Theme.Sherlock.Light</code>, or <code>Theme.Sherlock.Light.DarkActionBar</code>, or your custom theme must use one of the aforementioned as its parent.</p>
15  
-		<p>The themes should be defined in your manifest for the entire application or on a per-activity basis. You may also define the theme in the code of each activity <em>before</em> calling <code>super.onCreate(Bundle)</code>. This must be done for every activity on which you extend from one of the 'Sherlock' activity base classes and intend to use the action bar. More information on how to specify a theme can be found in the <a href="http://developer.android.com/guide/topics/ui/themes.html#ApplyATheme">official Android documentation</a>.</p>
16  
-
17  
-		<h3>Mirrored Attributes</h3>
18  
-		<p>Due to limitations in Android's theming system any theme customizations must be declared in two attributes. The normal <code>android</code>-prefixed attributes apply the theme to the native action bar and the unprefixed attributes are for the custom implementation. Since both theming APIs are exactly the same you need only reference your customizations twice rather than having to implement them twice.</p>
19  
-		<p>The easiest way to convey exactly what this entails is with an example. The following is the full theme from the &ldquo;Styled&rdquo; example mentioned above:</p>
20  
-		<pre>&lt;style name="Theme.Styled" parent="Theme.Sherlock.Light.DarkActionBar">
21  
-    &lt;item name="actionBarStyle">@style/Widget.Styled.ActionBar&lt;/item>
22  
-    &lt;item name="android:actionBarStyle">@style/Widget.Styled.ActionBar&lt;/item>
23  
-&lt;/style>
24  
-
25  
-&lt;style name="Widget.Styled.ActionBar" parent="Widget.Sherlock.Light.ActionBar.Solid.Inverse">
26  
-    &lt;item name="background">@drawable/bg_striped&lt;/item>
27  
-    &lt;item name="android:background">@drawable/bg_striped&lt;/item>
28  
-
29  
-    &lt;item name="backgroundSplit">@drawable/bg_striped_split&lt;/item>
30  
-    &lt;item name="android:backgroundSplit">@drawable/bg_striped_split&lt;/item>
31  
-&lt;/style></pre>
32  
-	</div>
33  
-</div>
  1
+---
  2
+title: Theming
  3
+layout: default
  4
+---
  5
+
  6
+<div class="row">
  7
+	<div class="whole" id="theming">
  8
+		<h1>Theming</h1>
  9
+
  10
+		<p>Theming of the action bar to work on all devices is a very straightforward and simple process. You should follow the existing theming recommendations for <a href="http://android-developers.blogspot.com/2011/04/customizing-action-bar.html">customizing the native action bar</a> with some minor tweaks.</p>
  11
+		<p>An example of a customized action bar can be seen in the &ldquo;Styled&rdquo; example in the 'Demos' sample.</p>
  12
+
  13
+		<h3>Parent Themes</h3>
  14
+		<p>In order for the custom action bar implementation to function your application must use <code>Theme.Sherlock</code>, <code>Theme.Sherlock.Light</code>, or <code>Theme.Sherlock.Light.DarkActionBar</code>, or your custom theme must use one of the aforementioned as its parent.</p>
  15
+		<p>The themes should be defined in your manifest for the entire application or on a per-activity basis. You may also define the theme in the code of each activity <em>before</em> calling <code>super.onCreate(Bundle)</code>. This must be done for every activity on which you extend from one of the 'Sherlock' activity base classes and intend to use the action bar. More information on how to specify a theme can be found in the <a href="http://developer.android.com/guide/topics/ui/themes.html#ApplyATheme">official Android documentation</a>.</p>
  16
+
  17
+		<h3>Mirrored Attributes</h3>
  18
+		<p>Due to limitations in Android's theming system any theme customizations must be declared in two attributes. The normal <code>android</code>-prefixed attributes apply the theme to the native action bar and the unprefixed attributes are for the custom implementation. Since both theming APIs are exactly the same you need only reference your customizations twice rather than having to implement them twice.</p>
  19
+		<p>The easiest way to convey exactly what this entails is with an example. The following is the full theme from the &ldquo;Styled&rdquo; example mentioned above:</p>
  20
+		<pre>&lt;style name="Theme.Styled" parent="Theme.Sherlock.Light.DarkActionBar">
  21
+    &lt;item name="actionBarStyle">@style/Widget.Styled.ActionBar&lt;/item>
  22
+    &lt;item name="android:actionBarStyle">@style/Widget.Styled.ActionBar&lt;/item>
  23
+&lt;/style>
  24
+
  25
+&lt;style name="Widget.Styled.ActionBar" parent="Widget.Sherlock.Light.ActionBar.Solid.Inverse">
  26
+    &lt;item name="background">@drawable/bg_striped&lt;/item>
  27
+    &lt;item name="android:background">@drawable/bg_striped&lt;/item>
  28
+
  29
+    &lt;item name="backgroundSplit">@drawable/bg_striped_split&lt;/item>
  30
+    &lt;item name="android:backgroundSplit">@drawable/bg_striped_split&lt;/item>
  31
+&lt;/style></pre>
  32
+	</div>
  33
+</div>
220  usage.html
... ...
@@ -1,105 +1,115 @@
1  
----
2  
-title: Usage
3  
-layout: default
4  
----
5  
-
6  
-
7  
-<script type="text/javascript">
8  
-$(function() {
9  
-	$.getJSON('https://api.github.com/repos/JakeWharton/ActionBarSherlock/tags?callback=?', function(response) {
10  
-		var meta = response.meta
11  
-		  , data = response.data
12  
-		;
13  
-
14  
-		data.sort(function(o1, o2) {
15  
-			return (o1.name > o2.name) ? -1 : 1;
16  
-		});
17  
-
18  
-		var last = data[0];
19  
-		$('.latest-version').html(last.name);
20  
-	});
21  
-});
22  
-</script>
23  
-
24  
-<div class="row">
25  
-	<div class="three-fourths">
26  
-		<h1>Usage</h1>
27  
-		<p>Sticking with the theme of the official compatibility 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>
28  
-
29  
-		<h3>Requirements</h3>
30  
-		<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>
31  
-		<p>Since the library is an extension of the official support library you must also have the <code>android-support-v4.jar</code> referenced by your project.</p>
32  
-
33  
-		<h3>Including In Your Project</h3>
34  
-		<p>There are a few ways to leverage ActionBarSherlock in your projects:</p>
35  
-		<ol>
36  
-			<li><p>If you’re using the <a href="http://www.eclipse.org/">Eclipse Development Environment</a> with the <a href="http://developer.android.com/sdk/eclipse-adt.html">ADT plugin</a> version 0.9.7 or greater you can include ActionBarSherlock as a library project. Create a new Android project in Eclipse using the <code>actionbarsherlock/</code> folder as the existing source. Then, in your project properties, add the created project under the ‘Libraries’ section of the ‘Android’ category.</p></li>
37  
-			<li><p>If you use <code>ant</code> to compile from the command line you will need to run <code>android update project -p .</code> inside the <code>actionbarsherlock/</code> folder of the project. Once completed, you can reference the <code>actionbarsherlock/</code> folder of ActionBarSherlock from your application's <code>project.properties</code> file. For more information please see the <a href="http://developer.android.com/guide/developing/projects/projects-cmdline.html#ReferencingLibraryProject">Android developer guide</a> for referencing library projects.</p></li>
38  
-			<li>
39  
-				<p>If you use maven to build your Android project you can simply add a dependency for this library.</p>
40  
-				<code><pre>
41  
-&lt;dependency>
42  
-  &lt;groupId>com.actionbarsherlock&lt;/groupId>
43  
-  &lt;artifactId>actionbarsherlock&lt;/artifactId>
44  
-  &lt;version><span class="latest-version">4.1.0</span>&lt;/version>
45  
-  &lt;type>apklib&lt;/type>
46  
-&lt;/dependency>
47  
-</pre></code>
48  
-			</li>
49  
-		</ol>
50  
-
51  
-		<h3>Action Bar API</h3>
52  
-		<p>When creating an activity to use the action bar on all versions of Android, you must declare your activity to extend any of the activity classes that start with 'Sherlock' (e.g., <code>SherlockActivity</code>, <code>SherlockFragmentActivity</code>). Interaction with the action bar is handled by calling <code>getSupportActionBar()</code> (instead of <a href="http://developer.android.com/reference/android/app/Activity.html#getActionBar()"><code>getActionBar()</code></a>).</p>
53  
-		<p>The API exposed by the <code>ActionBar</code> instance is an exact duplicate of <a href="http://developer.android.com/reference/android/app/ActionBar.html">that which the native method exposes</a>. Refer to its documentation as well as the articles on how to utilize its functionality in the &quot;Related Links&quot; section.</p>
54  
-		<p><strong>NOTE</strong>: When using <code>SherlockFragmentActivity</code> there are also 'Sherlock'-prefixed fragment classes which you should use to ensure proper functionality (e.g. <code>SherlockFragment</code>, <code>SherlockListFragment</code>). The activity will still function with the normal fragment classes but you will not be able to use any of the menu-related methods.</p>
55  
-
56  
-		<h3>Required Theming</h3>
57  
-		<p>Since the action bar widget is very complex it requires a set of default themes. The library provides three core themes&mdash;one of which <strong>must</strong> be applied to each activity on which you want the action bar present.</p>
58  
-		<p>See the <a href="theming.html">theming page</a> for more information.</p>
59  
-
60  
-		<h3>Imports</h3>
61  
-		<p>In order to provide functionality that was not available on version of Android prior to 3.0, the library includes and uses a lot of classes that are named the same as their native counterparts. The three most common are:</p>
62  
-		<ul>
63  
-			<li><code>com.actionbarsherlock.app.ActionBar</code></li>
64  
-			<li><code>com.actionbarsherlock.view.Menu</code></li>
65  
-			<li><code>com.actionbarsherlock.view.MenuItem</code></li>
66  
-			<li><code>com.actionbarsherlock.view.MenuInflater</code></li>
67  
-		</ul>
68  
-		<p>It is important to ensure that you are using these types where appropriate since they contain the additional functionality required to support the action bar.</p>
69  
-		<p><strong>NOTE</strong>: The majority of errors regarding the <code>@Override</code>-ing of methods from the activities are a result of using the incorrect imports. All of the classes which exist in the <code>com.actionbarsherlock.*</code> package whose names match that of a native class extend from that native class and as such can be used in their place.</p>
70  
-		<p><strong>NOTE</strong>: In order to inflate your menu from XML you should call <code>getSupportMenuInflater()</code> in your activities. The fragment callbacks will already have an instance of the inflater as an argument.</p>
71  
-
72  
-		<h3>See Also...</h3>
73  
-		<p>This library was meant to be as behind-the-scenes as possible and require a minimal amount of changes to support. The core usage of the action bar itself is no different than if you were interacting with the native action bar.</p>
74  
-		<p>Be sure to also visit the following pages:</p>
75  
-		<ul>
76  
-			<li><a href="theming.html">Theming</a></li>
77  
-			<li><a href="samples.html">Samples</a></li>
78  
-			<li><a href="faq.html">Frequently Asked Questions</a></li>
79  
-		</ul>
80  
-	</div>
81  
-	<div class="fourth last">
82  
-		<h1>Related Links</h1>
83  
-		<p>The following links are useful information on how to operate the native action bar. Other than the small tweaks mentioned on this page, the entire API is exactly the same.</p>
84  
-
85  
-		<h3>Class APIs</h3>
86  
-		<dl>
87  
-			<dt><a href="http://developer.android.com/reference/android/app/ActionBar.html">ActionBar</a></dt>
88  
-			<dd>Main API for nearly all interaction with the action bar. <strong>This is the exact API <code>getSupportActionBar()</code> exposes.</strong></dd>
89  
-			<dt><a href="http://developer.android.com/reference/android/app/Fragment.html">Fragment</a></dt>
90  
-			<dd>New fundamental building block of layouts which enable you to provide rich experiences on a range of different devices without code duplication.</dd>
91  
-		</dl>
92  
-
93  
-		<h3>Articles</h3>
94  
-		<dl>
95  
-			<dt><a href="http://developer.android.com/guide/topics/ui/actionbar.html">Using the ActionBar</a></dt>
96  
-			<dd>Broad introduction on the action bar design paradigm, the API, and common use cases.</dd>
97  
-			<dt><a href="http://developer.android.com/guide/topics/ui/menus.html">Creating Menus</a></dt>
98  
-			<dd>Menus drive the action bar's items.</dd>
99  
-			<dt><a href="http://developer.android.com/sdk/compatibility-library.html#Using">Using the Compatibility Libary</a></dt>
100  
-			<dd>ActionBarSherlock is a superset of the official compatibility library. All features in the Google library are also available for use through this library.</dd>
101  
-			<dt><a href="http://developer.android.com/guide/topics/fundamentals/fragments.html">Fragments</a></dt>
102  
-			<dd>Introduction to utilizing this new modularized view and its lifecycle.</dd>
103  
-		</dl>
104  
-	</div>
105  
-</div>
  1
+---
  2
+title: Usage
  3
+layout: default
  4
+---
  5
+
  6
+
  7
+<script type="text/javascript">
  8
+$(function() {
  9
+	$.getJSON('https://api.github.com/repos/JakeWharton/ActionBarSherlock/tags?callback=?', function(response) {
  10
+		var meta = response.meta
  11
+		  , data = response.data
  12
+		;
  13
+
  14
+		data.sort(function(o1, o2) {
  15
+			return (o1.name > o2.name) ? -1 : 1;
  16
+		});
  17
+
  18
+		var last = data[0];
  19
+		$('.latest-version').html(last.name);
  20
+	});
  21
+});
  22
+</script>
  23
+
  24
+<div class="row">
  25
+	<div class="three-fourths">
  26
+		<h1>Usage</h1>
  27
+		<p>Sticking with the theme of the official compatibility 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>
  28
+
  29
+		<h3>Requirements</h3>
  30
+		<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>
  31
+		<p>Since the library is an extension of the official support library you must also have the <code>android-support-v4.jar</code> referenced by your project.</p>
  32
+
  33
+		<h3>Including In Your Project</h3>
  34
+		<p>There are a few ways to leverage ActionBarSherlock in your projects:</p>
  35
+		<ol>
  36
+			<li><p>If you’re using the <a href="http://www.eclipse.org/">Eclipse Development Environment</a> with the <a href="http://developer.android.com/sdk/eclipse-adt.html">ADT plugin</a> version 0.9.7 or greater you can include ActionBarSherlock as a library project. Create a new Android project in Eclipse using the <code>actionbarsherlock/</code> folder as the existing source. Then, in your project properties, add the created project under the ‘Libraries’ section of the ‘Android’ category.</p></li>
  37
+			<li><p>If you use <code>ant</code> to compile from the command line you will need to run <code>android update project -p .</code> inside the <code>actionbarsherlock/</code> folder of the project. Once completed, you can reference the <code>actionbarsherlock/</code> folder of ActionBarSherlock from your application's <code>project.properties</code> file. For more information please see the <a href="http://developer.android.com/guide/developing/projects/projects-cmdline.html#ReferencingLibraryProject">Android developer guide</a> for referencing library projects.</p></li>
  38
+			<li>
  39
+				<p>If you use maven to build your Android project you can simply add a dependency for this library.</p>
  40
+				<code><pre>
  41
+&lt;dependency>
  42
+  &lt;groupId>com.actionbarsherlock&lt;/groupId>
  43
+  &lt;artifactId>actionbarsherlock&lt;/artifactId>
  44
+  &lt;version><span class="latest-version">4.1.0</span>&lt;/version>
  45
+  &lt;type>apklib&lt;/type>
  46
+&lt;/dependency>
  47
+</pre></code>
  48
+			</li>
  49
+			<li>
  50
+				<p>If you use gradle to build your Android project, you must manually specify the packaging type of 'aar' and the support library dependency:</p>
  51
+				<code><pre>
  52
+dependencies {
  53
+  compile 'com.actionbarsherlock:actionbarsherlock:4.4.0@aar'
  54
+  compile 'com.android.support:support-v4:18.0.+'
  55
+}
  56
+</pre></code>
  57
+			</li>
  58
+		</ol>
  59
+
  60
+		<h3>Action Bar API</h3>
  61
+		<p>When creating an activity to use the action bar on all versions of Android, you must declare your activity to extend any of the activity classes that start with 'Sherlock' (e.g., <code>SherlockActivity</code>, <code>SherlockFragmentActivity</code>). Interaction with the action bar is handled by calling <code>getSupportActionBar()</code> (instead of <a href="http://developer.android.com/reference/android/app/Activity.html#getActionBar()"><code>getActionBar()</code></a>).</p>
  62
+		<p>The API exposed by the <code>ActionBar</code> instance is an exact duplicate of <a href="http://developer.android.com/reference/android/app/ActionBar.html">that which the native method exposes</a>. Refer to its documentation as well as the articles on how to utilize its functionality in the &quot;Related Links&quot; section.</p>
  63
+		<p><strong>NOTE</strong>: When using <code>SherlockFragmentActivity</code> there are also 'Sherlock'-prefixed fragment classes which you should use to ensure proper functionality (e.g. <code>SherlockFragment</code>, <code>SherlockListFragment</code>). The activity will still function with the normal fragment classes but you will not be able to use any of the menu-related methods.</p>
  64
+
  65
+		<h3>Required Theming</h3>
  66
+		<p>Since the action bar widget is very complex it requires a set of default themes. The library provides three core themes&mdash;one of which <strong>must</strong> be applied to each activity on which you want the action bar present.</p>
  67
+		<p>See the <a href="theming.html">theming page</a> for more information.</p>
  68
+
  69
+		<h3>Imports</h3>
  70
+		<p>In order to provide functionality that was not available on version of Android prior to 3.0, the library includes and uses a lot of classes that are named the same as their native counterparts. The three most common are:</p>
  71
+		<p>In order to provide functionality that was not available on version of Android prior to 3.0, the library includes and uses a lot of classes that are named the same as their native counterparts. The most common of these are:</p>
  72
+		<ul>
  73
+			<li><code>com.actionbarsherlock.app.ActionBar</code></li>
  74
+			<li><code>com.actionbarsherlock.view.Menu</code></li>
  75
+			<li><code>com.actionbarsherlock.view.MenuItem</code></li>
  76
+			<li><code>com.actionbarsherlock.view.MenuInflater</code></li>
  77
+		</ul>
  78
+		<p>It is important to ensure that you are using these types where appropriate since they contain the additional functionality required to support the action bar.</p>
  79
+		<p><strong>NOTE</strong>: The majority of errors regarding the <code>@Override</code>-ing of methods from the activities are a result of using the incorrect imports. All of the classes which exist in the <code>com.actionbarsherlock.*</code> package whose names match that of a native class extend from that native class and as such can be used in their place.</p>
  80
+		<p><strong>NOTE</strong>: In order to inflate your menu from XML you should call <code>getSupportMenuInflater()</code> in your activities. The fragment callbacks will already have an instance of the inflater as an argument.</p>
  81
+
  82
+		<h3>See Also...</h3>
  83
+		<p>This library was meant to be as behind-the-scenes as possible and require a minimal amount of changes to support. The core usage of the action bar itself is no different than if you were interacting with the native action bar.</p>
  84
+		<p>Be sure to also visit the following pages:</p>
  85
+		<ul>
  86
+			<li><a href="theming.html">Theming</a></li>
  87
+			<li><a href="samples.html">Samples</a></li>
  88
+			<li><a href="faq.html">Frequently Asked Questions</a></li>
  89
+		</ul>
  90
+	</div>
  91
+	<div class="fourth last">
  92
+		<h1>Related Links</h1>
  93
+		<p>The following links are useful information on how to operate the native action bar. Other than the small tweaks mentioned on this page, the entire API is exactly the same.</p>
  94
+
  95
+		<h3>Class APIs</h3>
  96
+		<dl>
  97
+			<dt><a href="http://developer.android.com/reference/android/app/ActionBar.html">ActionBar</a></dt>
  98
+			<dd>Main API for nearly all interaction with the action bar. <strong>This is the exact API <code>getSupportActionBar()</code> exposes.</strong></dd>
  99
+			<dt><a href="http://developer.android.com/reference/android/app/Fragment.html">Fragment</a></dt>
  100
+			<dd>New fundamental building block of layouts which enable you to provide rich experiences on a range of different devices without code duplication.</dd>
  101
+		</dl>
  102
+
  103
+		<h3>Articles</h3>
  104
+		<dl>
  105
+			<dt><a href="http://developer.android.com/guide/topics/ui/actionbar.html">Using the ActionBar</a></dt>
  106
+			<dd>Broad introduction on the action bar design paradigm, the API, and common use cases.</dd>
  107
+			<dt><a href="http://developer.android.com/guide/topics/ui/menus.html">Creating Menus</a></dt>
  108
+			<dd>Menus drive the action bar's items.</dd>
  109
+			<dt><a href="http://developer.android.com/sdk/compatibility-library.html#Using">Using the Compatibility Libary</a></dt>
  110
+			<dd>ActionBarSherlock is a superset of the official compatibility library. All features in the Google library are also available for use through this library.</dd>
  111
+			<dt><a href="http://developer.android.com/guide/topics/fundamentals/fragments.html">Fragments</a></dt>
  112
+			<dd>Introduction to utilizing this new modularized view and its lifecycle.</dd>
  113
+		</dl>
  114
+	</div>
  115
+</div>

0 notes on commit b80a985

Please sign in to comment.
Something went wrong with that request. Please try again.