Permalink
Browse files

improved documentation

  • Loading branch information...
1 parent 81b23cb commit 0cd5efac285fed63f43f7f3134dc9316d76a2c09 @robert-virkus robert-virkus committed May 30, 2012
@@ -533,7 +533,7 @@
<param name="bottom-background" type="background" description="Reference to the background that is painted on the right side. Reference a background defined in the backgrounds section." />
<param name="split-pos" type="dimension" primitive="true" default="50%" description="The split position either in percent (1% - 100%) or in pixels. 0 has a special meeting - it results in a rectangular split area." />
<param name="split-side" type="integer" primitive="true" values="top,bottom" default="top" description="The side of the split position - usually makes only sense when using an absolute pixel value, e.g. when you want to have a top height of 40 pixels, e.g. for accomodating an image." />
- <param name="margin" type="integer" primitive="true" default="0" description="The margin in pixels between the top and the nottom background" />
+ <param name="margin" type="integer" primitive="true" default="0" description="The margin in pixels between the top and the bottom background" />
</mapping>
<mapping from="mask" to="de.enough.polish.ui.backgrounds.MaskBackground" converter="de.enough.polish.preprocess.backgrounds.MaskBackgroundConverter">
<param name="mask" type="background" />
@@ -61,9 +61,9 @@ <h2 id="Design">Design Samples</h2>
border: none;
layout: horizontal-center | horizontal-expand;
background {
- <b>type: combined;
+ type: combined;
foreground: titleForeground;
- background: titleBackground;</b>
+ background: titleBackground;
}
}
@@ -164,11 +164,11 @@ <h2 id="Design">Design Samples</h2>
layout: right | expand;
text-effect: split;
text-split-bottom-color: #ddd;
- <b>background {
+ background {
type: combined;
foreground: titleText;
background: titleBg;
- }</b>
+ }
}
</pre>
<p>
@@ -205,11 +205,11 @@ <h2 id="Design">Design Samples</h2>
font-size: large;
font-style: bold;
font-color: #ccc;
- <b>background {
+ background {
type: combined;
foreground: titleCircle;
background: titleBg;
- }</b>
+ }
layout: left | expand;
}
</pre>
@@ -289,6 +289,38 @@ <h2 id="android-configuring-manifest">Configure your AndroidManifest.xml</h2>
/&gt;
&lt;/manifest&gt;
</pre>
+<p>
+In the above example we support small, normal, large and extra large screens. Note that this is done by default with the additional setting that all screen densities are also supported.
+</p>
+<p>
+If you are using an Android service in your application, you need to define within the <code>&lt;application&gt;</code> element:
+</p>
+<pre class="brush: xml">
+&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
+&lt;manifest xmlns:android=&quot;http://schemas.android.com/apk/res/android&quot;&gt;
+ &lt;application&gt;
+ &lt;service
+ android:name=&quot;com.company.product.AddOnService&quot;
+ android:process=&quot;:addon_service&quot;
+ android:label=&quot;AddOnService&quot;
+ &gt;
+ &lt;/service&gt;
+ &lt;/application&gt;
+&lt;/manifest&gt;
+</pre>
+<p>
+Note that the <code>&lt;application&gt;</code> element is automatically populated by J2ME Polish, so you do not need to enter your details there. This is the same for any elements
+that are auto-populated; in that case the existing elements will not be replaced but only complimented by your changes.
+<br />
+An element attribute, however, will overwrite an existing attribute of an existing element. The following code sets the label of the application to a custom Android one, for example:
+</p>
+<pre class="brush: xml">
+&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
+&lt;manifest xmlns:android=&quot;http://schemas.android.com/apk/res/android&quot;&gt;
+ &lt;application android:label=&quot;Custom Android Name&quot; &gt;
+ &lt;/application&gt;
+&lt;/manifest&gt;
+</pre>
<table class="borderedTable" cellspacing="0" cellpadding="3" border="1">
<tr>
@@ -401,7 +433,7 @@ <h3 id="android-configuration-alerts">Configure Alerts</h3>
Use the <code>polish.useNativeAlerts</code> preprocessing variable for enabling native alerts:
</p>
<pre class="brush: xml">
-&lt;variable name=&quot;polish.useNativeAlerts&quot; value=&quot;false&quot; if=&quot;polish.android || polish.blackberry&quot; /&gt;
+&lt;variable name=&quot;polish.useNativeAlerts&quot; value=&quot;true&quot; if=&quot;polish.android || polish.blackberry&quot; /&gt;
</pre>
<p>
<img src="<%= basedir%>images/gui-android-alert-native.png" width="480" height="799" alt="Native Android Alert" />

0 comments on commit 0cd5efa

Please sign in to comment.