Toolbar Mode

• Global - Use the Global toolbar settings from the Theme tab of your project.
• Parent - Use the activity's parent dashboard toolbar settings. These settings are defined in the Toolbar section of the the parent dashboard's properties.
• Custom - Enables the Custom Toolbar Settings section of settings allowing you to customize the toolbar style for the activity.

Custom Toolbar Settings

Toolbar Style

• Standard - Use a standard toolbar with a solid color background. If a feature image is enabled, it will appear "outside" the toolbar, and will scroll beneath it as the activity contents are scrolled.
• Compact - Use a compact toolbar. A compact toolbar is similar to the standard toolbar, but with support for showing the feature image as the toolbar background, appearing "inside" the toolbar.
• Expanded - Use an expanded toolbar which is a collapsible toolbar that starts out expanded. If a feature image is enabled, it will appear within the expanded toolbar, and collapse along with it.

Scroll Behavior

• Always visible - Keep the toolbar visible when scrolling activity content.
• Auto hiding - Automatically hide the toolbar when scrolling activity content.

Show Advanced Settings
Shows or hides the Advanced Toolbar Settings for the selected style containing settings such as the Background Type, Background Color, Automatic Background Color Preference and Primary Toolbar Text/Icon Color.

Advanced Toolbar Settings

Background Type
This setting is available when "Compact" or "Expanded" Toolbar Style is selected.

• Color - Use a solid color for the toolbar background.
• Feature Image - Use the activity's feature image as the toolbar background.
• Feature image morphing to color (Expanded toolbar style only) - Morph the activity's feature image into a solid color as it collapses.

Background Color

Primary - Use the global Primary color as the background.
Automatic - Automatically select a background color based on the provided Feature Image.
Nearest material primary - Automatically select a background color based on the provided Feature Image, but use the nearest primary color from the material palette (subset of recommended primary colors).

Automatic Background Color Preference
This setting is available when "Automatic" or "Nearest Material Primary" Background Color is selected.

• Automatic - Automatically select a light or dark color based on the overall "darkness" of the provided Feature Image.
• Light - Use a "light" color for the background. If no light color is available, the primary color will be used.
• Dark - Use a "dark" color for the background. If no dark color is available, the primary color will be used.

Primary Toolbar Text/Icon Color

• Automatic - Automatically select a color for the toolbar text and action icons based on the primary color.
• Custom - Enables the Custom Toolbar Text/Icon Color setting allowing you to choose a custom color for the toolbar text and icons.

Custom Toolbar Text/Icon Color
The color you want to use for the toolbar text and icons. This setting is available when "Custom" is selected as the Primary Toolbar Text/Icon Color. This setting is ignored unless Background Color is set to "Primary."

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer.

Background Image (Where Available)
The background image is an optional image that can be shown behind the activity's content (only available on some activity types).

• None - Don't use a background image.
• Inherit from theme - Use the theme's background image. The theme is specified by the Theme Mode of the activity.
• Custom - Enables the Custom Background Image Settings section of settings allowing you to upload a background image for the activity.

Custom Background Image Settings
The following settings are available when "Custom" Background Image is selected:

Upload a Background Image
Allows you to upload a background image. Click the "Browse" button to select an image file from your computer. The selected image should be a maximum of 1440x1440, 1.5 MB, JPG or PNG format.

Background Image Effect
Applies a filter to the background image when it is shown in the app, changing the color of the image automatically. This can help improve the contrast of text drawn over the background image -- for example, darkening the background to improve the readibility of brightly colored text.

• None - No filter (show the original image unchanged).
• Darken - Darken the image by 40%, i.e. scale the original color into [0-153] instead of [0-255].
• Lighten - Lighten the image by 60%, i.e. scale the original color into [153-255] instead of [0-255].
• Midnight - Darken + Greyscale.
• Twilight - Lighten + Greyscale.
• Greyscale - Convert all colors to shades of grey, i.e. desaturate the image.
• Tint - Modify the image so it takes on the current primary/automatic toolbar color.

Feature Image
The feature image is an optional image that can be shown as the background of the activity's toolbar or at the top of the content (outside of the toolbar).

• None - Don't use a feature image.
• Inherit from theme - Use the theme's feature image. The theme is specified by the Theme Mode of the activity.
• Custom - Enables the Custom Feature Image Settings section of settings allowing you to upload a feature image for the activity.

Custom Feature Image Settings
The following settings are available when "Custom" Feature Image is selected:

Aspect Radio
The aspect ratio of the area where the feature image will be shown. This setting controls the initial height of the toolbar when using an Expanded toolbar style, or the height of the feature image outside a Standard toolbar.

Upload a Feature Image
Allows you to upload a feature image. Click the "Browse" button to select an image file from your computer. The selected image should be a maximum of 1440x1440, 1.5 MB, JPG or PNG format.

Wide Image
The wide image to use to represent this activity on the dashboard when a "wide" item style is used.

• None - Don't use a wide image.
• Inherit from theme - Use the provided Wide image from the theme.
• Use feature image - Use the provided Feature Image when a wide image is requested in an interface.
• Custom - Specify a wide image to use. Selecting this option enables the Custom Wide Image Settings section containing the settings to use for a wide image.

Custom Wide Image Settings
The following settings are available when "Custom" Wide Image is selected:

Upload a Wide Image
Allows you to upload a wide image (16:9 aspect ratio recommended). Click the "Browse" button to select an image file from your computer. The selected image should be a maximum of 1440x1440, 1.5 MB, in JPG or PNG format.

Square Image
The square image to use to represent this activity on the dashboard when a "square" item style is used.

• None - Don't use a square image.
• Inherit from theme - Use the provided Square image from the theme.
• Use wide image, cropped - Use the provided Wide image when a square image is requested in an interface.
• Use feature image, cropped - Use the provided Feature image when a square image is requested in an interface.
• Use legacy icon image - Use your Andromo v4 icon image when a square image is requested in an interface. This option is only available for projects that were created in Andromo v4.
• Custom - Specify a square image to use. Selecting this option enables the Custom Square Image Settings section containing the settings to use for a square image.

Custom Square Image Settings
The following settings are available when "Custom" Square Image is selected:

Upload a Square Image
Allows you to upload a square image (1:1 aspect ratio). Click the "Browse" button to select an image file from your computer. The selected image should be a maximum of 1440x1440, 1.5 MB, in JPG or PNG format.

Drawer Icon
The icon you want to use to represent the activity on the navigation drawer and the dashboard when an "icon" item style is used. Select an icon from the dropdown. If you do not want an icon, you can select the first blank item from the list (after selection it will show "Nothing selected").

Theme Mode

• Global - Use the project's Global Theme Settings for the activity. These settings are defined on the "Theme" tab of your project.
• Parent - Use the activity's parent dashboard theme settings. These settings are defined in the Theme section of the the parent dashboard's properties.
• Custom - Enables the Custom Theme Colors settings allowing you to choose what colors you want to use on this activity.

Custom Theme Colors
The following settings are available when "Custom" Theme Mode is selected:

Primary Color
The primary color you want to use for the activity. The primary color is generally your app's "branding" color. It is used for toolbar backgrounds and to represent the activity when images aren't provided.

Accent Color
The accent color you want to use for the activity. The accent color is used for parts of the UI such as buttons/gadgets and hyperlinks (where applicable).

Body Style
This setting controls what colors are used in the "body" of activity content, such as it's background and text color.

• Material Light - Use the standard Material colors for a body with a light background.
• Material Dark - Use the standard Material colors for a body with a dark background.
• Custom - Enables the Custom Body Colors settings, allowing you to set a custom Window Color, Background Color and Text Color.

Custom Body Colors
The following settings are available when "Custom" Body Style is selected:

Window Color
The color you want to use for the bottom-most window background (i.e. the area 'behind' cards). You can think of this color as being behind the Background Color. It will only be visible when it isn't obscured by the Background Color -- for example, the window color becomes visible when a "card" item style is used.

Background Color
The color you want to use for the background of areas where text may be shown (e.g. the card background color).

Text Color
The color you want to use for all body text, including primary and secondary text. Opacity is applied to different text levels automatically per material guidelines.

Error Codes: If you encounter any error messages/codes in your app while testing, please see the YouTube Activity Error Codes section of this article for a description of the error.

Note: This activity uses the YouTube Data API v3. All applications must register to obtain the proper authorization credentials. See the "YouTube API Key" setting for further details.

Adding a YouTube Activity

To add a YouTube activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select YouTube from the list.

Now let's take a look at the YouTube Activity settings. For the purpose of this article we will use the Google I/O YouTube video Playlist.

Settings

Activity Name
The name that you want to give to your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe the items that you will be displaying. For our example we'll use "Android I/O"

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the section HTML Archive Activity  in wich you will find the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Display videos by
This setting controls which value will be used to generate your list of videos. Choose from Username, Channel ID, Playlist ID, Search phrase, or Single video.

Username
Show videos belonging to a specific user using their YouTube username, such as AndromoAppMaker.

Channel ID
Shows videos belonging to a channel using it's YouTube Channel ID.

Playlist ID
Show videos belonging to a playlist using a YouTube playlist ID, such as Andromo's Quick Tips playlist, PLQIkRevU6k8XJUjoQ2qmjyl6Vovwa6npR.

Search phrase
Show videos matching a YouTube search phrase or query, such as porsche+red.

Single video URL
Show a single video using it's full URL provided by YouTube such as: http://www.youtube.com/watch?v=HguXVfPgpBY. This option will open the video directly, instead of showing a list.

YouTube API Key
Note: This setting isn't required for the 'Single video URL' option.

In order to submit API requests to YouTube's Data API v3, you must register your application to obtain the proper authorization credentials. To register your application, go to the Google Developer Console to create your project and your YouTube API Key. For more information, see the article Creating a YouTube API Key.

Item Style
The item style you want to use to show the index of YouTube videos. Choose from styles such as cards, grids, and lists including which content you want to show.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

YouTube Activity Error Codes

If an error is encountered while requesting the data from YouTube's API, the app will show a message containing an error code, such as "YouTube Data Error (53)". Below are descriptions of Andromo's error codes that you may encounter. You can use these to help diagnose any incorrect values you've entered.

• 50 - An error occurred when trying to initialize the YouTube Data API.
• 53 - The YouTube API Key you've entered is invalid.
• 54 - The Playlist ID you've entered is invalid or not found.
• 55 - The Username you've entered is invalid or not found.
• 56 - No 'uploads' were returned for the username you've specified.
• 57 - You're not authorized to retrieve the specified playlist.
• 58 - You have exceeded your YouTube quota.
• 59 - Access Not Configured. Please use Google Developers Console to activate the API for your project.
• 99 - An unknown error occurred while retrieving the YouTube data.

  ---

What the YouTube Activity Contains

The YouTube Activity contains one activity, a list of items generated by the YouTube request. When you initially visit this activity it will be blank, and your Andromo app will query YouTube using their API and populate it with items. Each item will contain a title, date the item was published, a short description, and a video thumbnail (the specific elements shown will depend on what Item Style you select):

You can scroll through the list and select an item to view. When you click on an item you will be brought to YouTube app where you can view the video. If the YouTube app is not installed then the video will be opened in the user's web browser.

Adding a Website Activity

To add a Website activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Website from the list.

Now let's take a look at the Website Activity settings. For the purpose of this article we will use the Andromo blog.

Settings

The Website activity contains the following settings.

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe the website that you will be displaying. For our example, we'll use "Andromo Blog"

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

 Details

Website URL
The website that will be displayed within your application. It must be a complete URL like: http://www.andromo.com or http://blog.andromo.com

Orientation
This setting allows you to force the activity to stay in a particular orientation. Leave this on 'Automatic' unless you absolutely need to lock the display orientation for some reason (like games etc.).

• Automatic - Switch orientations automatically (the normal behavior).
• Landscape - Lock this activity in landscape orientation.
• Portrait - Lock this activity in portrait orientation.

Banner ads

This controls which banner ad networks will be permitted on this activity when banner ads are enabled for the app.

You can choose whether to permit all ads, all ads except Google AdMob ads, or to prevent any ads from appearing in this activity at all.

Google does not permit AdMob ads to be shown alongside web content containing Google AdSense ads. Refer to the AdMob terms of use and content guidelines for details.

Enable Geolocation permissions
You can enable this option if the website needs access to HTML5 Geolocation features. When this feature is enabled, the appropriate permissions will be added to the app requesting access to their location.

Enable Zoom
You can enable this to allow zooming in or out using on-screen zoom controls and gestures. Generally you should only disable this if your website is mobile friendly.

Open website in external browser
You can enable this to open the website outside of the app, within the default browser.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

What the Website Activity Contains

The Website activity is made up of one activity that displays the contents of the Website URL set in your activity settings.

Linking to Another Activity

The Website activity also allows you to open another activity from a link using the special URL format:

andromo://<<internal-activity-identifier>>

Each activity contains an internal unique identifier that can be referenced for opening it. You can find each activity's reference URL in the section labeled "Activity URL" located below the activity's Example Screenshot. Each activity's settings can be accessed from the "Activities" tab, by clicking the desired activity name or icon, or by selecting "Edit" from its Action drop-down list. It will appear as a value such as:

where "website801769" is the internal identifier for that particular activity. This value will be different for each activity in your project.

As an HTML hyperlink, this would be formatted as:

<a href="andromo://website801769">Visit Our Website</a>

If you'd like to open the dashboard, you can specify the following:

andromo://dashboard

As an HTML hyperlink, this would be formatted as:

<a href="andromo://dashboard">Go Home</a>

Example Screenshot

Adding a Twitter Activity

To add a Twitter activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Twitter from the list.

Settings

Activity Name
The name that will be given to your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe the feed that you will be displaying. For our example we'll use "Andromo Tweets"

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Twitter Mode

• Tweets by a specific Twitter Username - This option will show the tweets from a specific Twitter user’s timeline.
• Tweets from a Twitter List - Show all the latest tweets contained within a users list. Learn more about lists on the twitter website: http://support.twitter.com/articles/76460-how-to-use-twitter-lists
• Tweets that match a Search Phrase - Searches all public Tweets for keywords, usernames, hashtags, or subject and displays the results.

Twitter Username
The Twitter screen name/username of the user whose timeline will be shown. e.g @AndromoRocks

Twitter List
The exact name of the list to display, this list must be a list that the user either owns or subscribes to. E.g Android News.

Search Phrase
The string to search for, the timeline returned will be the public tweets that match this search string. e.g. Andromo, or “New York”.

Twitter OAuth Settings

Andromo's Twitter activity requires that you identify your application to Twitter for making requests by way of an API key and secret. This is usually referred to as your "consumer key" and "consumer secret". You can generate these two values by registering your app on Twitter's Application Management page. For more information about getting your Twitter API Keys, please see the article Twitter Oauth Settings.

Consumer key
Your app's "Consumer key" value located in your Twitter application's record on the "Details" tab under "OAuth settings".

Consumer secret
Your app's "Consumer secret" value located in your Twitter application's record on the "Details" tab under "OAuth settings".

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

What the Twitter Activity Contains

The Twitter Activity contains one activity, a list of tweets in the specified timeline. When you initially visit this activity it will be blank, and your Andromo app will query the twitter servers and populate it with tweets if there are any. Each item will contain the user’s name, screen name, a date the tweet was published, and the tweet text itself.

You can scroll through the list and select an item to view. When you click on a tweet you will be able to view the tweet and any other related tweets either in the web browser or the twitter application.

Long clicking on a tweet will bring up a context menu letting you share the tweet or follow the user that created the tweet.

It's similar to the Audio activity, with additional support for SHOUTcast and Icecast streaming audio.

Example Screenshot

Adding a Radio Activity

To add a Radio activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select SHOUTcast Radio from the list.

Settings

Activity Name
The name for this activity. This will appear on the dashboard, toolbar, and navigation drawer. It can be whatever you want. For example: "National Public Radio"

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
A relative index that controls the order of the activities in your application. The position affects where your activity is displayed on the dashboard and navigation drawer. You can use any value you want; all that matters is how the value compares to the position indexes of other activities.

For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Radio Type
The type of radio URL you're connecting to. Choose from the following three options:

• Playlist - an .m3u, .pls, or .asx file containing links to individual audio tracks
• SHOUTcast Playlist - an .m3u, .pls, or .asx file containing links to SHOUTcast/Icecast server streams
• SHOUTcast Stream - a direct link to a SHOUTcast/Icecast server stream

Choosing Playlist or SHOUTcast Playlist will make the app treat the URL as a playlist file. It will attempt to download the file at that URL and parse it in order to expand it into individual tracks.

Choosing SHOUTcast Playlist or SHOUTcast Stream will make the app treat the URL as a SHOUTcast or Icecast server. It will connect to the server every 30 to 60 seconds in order to retrieve metadata about the radio channel and the current song. If successful, this information will be shown above the media controls at the bottom of the screen:

Note: not all SHOUTcast servers provide this information. If your channel doesn't transmit the song titles, you may want to switch to the Playlist setting so your app doesn't use any bandwidth attempting to retrieve the metadata.

URL
The URL of your playlist or SHOUTcast stream. Make sure you choose the appropriate Radio Type for the file this URL points to.

For example, http://yp.shoutcast.com/sbin/tunein-station.pls?id=21585 is the URL to a SHOUTcast playlist file.

Enable sharing
This checkbox controls whether or not the share icon/menu item will be shown on the activity's toolbar and context menu.

Autoplay first track
Automatically start playing the first track after opening this activity.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

Andromo supports the following feed versions: RSS 9.0, RSS 1.0, RSS 2.0, and Atom 1.0. Many websites publish feeds in one or more of these formats.

Example Screenshot

What if I don't have any feeds?

Chances are you have more feeds that you think you do. If you have an online presence; produce or consume online content you are probably creating a feed or accessing sites that are producing feeds. If you have a twitter account, write a blog, post photos online, use google+, participate in a forum or online community, you are probably creating a feed. The trick is to discover where those feeds are and which feeds should be in your application.

Adding an RSS Feed Activity

To add an RSS Feed activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select RSS Feed from the list.

Now let's take a look at the RSS Feed Activity settings. For the purpose of this article we will use the andromo blog's atom feed [http://blog.andromo.com/feed/atom/]

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe the feed that you will be displaying. For our example we'll use "Andromo Blog"

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme 

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

RSS/Atom Feed URL
This is the URL of the feed that you would like to display. For example, we'll use: http://blog.andromo.com/feed/atom/

Tip: You can use the Feed Validator to test if a particular feed is valid.

RSS Activity Type
There are two activity types available for the RSS activity, Classic RSS Feed, or Photo Feed. Each have their own settings as described below.

Classic RSS Feed
Useful for text-based feeds. By default each feed item is displayed as a row in a list of feed items on the index activity. Each list item will contain a thumbnail (if available), title, description and the date the post was made. You can control the interface style and what content is shown by selecting a different Item Style.

Item Style
The item style you want to use for the index page of the RSS content. Choose from styles such as cards, grids, and lists including which content you want to show.

When items are no longer in the feed
These settings control how to handle items that are no longer in the current feed data.

• Cache them - Cache the items so they continue to show in the list.
• Hide them - Hide the items that are no longer in the feed.
• Remove them - Remove the items that are no longer in the feed.

When clicking an item
These settings are only visible when "Classic RSS Feed" is selected as the RSS Activity Type.

This controls what happens when the end user clicks or presses on an item in the list.

• Show RSS item content - Show the content contained within the RSS feed in the RSS content activity.
• Open destination link in app - Open the link associated with the RSS item within the RSS content activity.
• Open destination link in Android browser - Open the destination link, outside of the app, within the default Android browser.

Banner ads

These settings are only visible when "Classic RSS Feed" is selected as the RSS Activity Type.

This controls which banner ad networks will be permitted on this RSS feed's content page when banner ads are enabled for the app. This only affects the content page -- the ads shown on the list of RSS feed items will not be affected by this setting.

You can choose whether to permit all ads, all ads except Google AdMob ads, or to prevent any ads from appearing in this activity at all.

Google does not permit AdMob ads to be shown alongside web content containing Google AdSense ads. Refer to the AdMob terms of use and content guidelines for details.

Photo Feed

Useful for image based feeds. By default items will be displayed as a grid of thumbnails. When the user clicks on one of the thumbnails they will be able to view the full sized image. You can control the interface style and what content is shown by selecting a different Item Style.

Show descriptions on photo?
This setting is only visible when "Photo Feed" is selected as the RSS Activity Type.

Whether or not to show the item's description on the photo content page.

Enable Set-picture-as?
This setting is only visible when "Photo Feed" is selected as the RSS Activity Type.

Whether or not the user has the ability to set the photo as their device’s wallpaper, contact photo, or any other available system dependent option.

 Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

What the RSS Activity Contains

The RSS Activity contains two activities. The first is a list of items in the feed. When you initially visit this activity it will be blank, and your Andromo app will query the feed and populate it with items. Each item will contain a title and a date the item was published. Most items will also show a short description, and some feed items will have icons associated with them (what you see on the index page depends upon what Item Style you select).

You can scroll through the list and select an item to read. When you click on a feed item you will be brought to the content activity. This activity will show you the title of the feed, the URL associated with the feed item, and the content of the feed item. Some feeds will publish all of the text, and other will only publish the first few sentences, it is up to the feed creator. From there the user will be able to click on the link and view the item in the default Android web browser.

Example Screenshots

The Podcast activity displays the feed as a list of episodes.

Tapping on an episode takes you to another activity where the summary/description text is shown.

You can long-press on the Play button for additional options.

You can also interact with the episodes directly from the list.

Adding a Podcast Activity

To add a Podcast activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Podcast from the list.

Settings

Activity Name
The name for this activity. This will appear on the dashboard, toolbar, and navigation drawer. It can be whatever you want. For example: "Rock Paper Shotgun"

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
A relative index that controls the order of the activities in your application. The position affects where your activity is displayed on the dashboard and navigation drawer. You can use any value you want; all that matters is how the value compares to the position indexes of other activities.

For more information on this setting please read: How to change the order of the icons on the dashboard

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Podcast URL
The URL of your podcast RSS feed. It should conform to the RSS 2.0 specification and include the iTunes RSS tags as documented here: Making a Podcast

Note: only audio feeds are supported (video feeds cannot be shown).

Enable sharing
This checkbox controls whether or not the share icon/menu item will be shown on the activity's toolbar and context menu.

Autoplay first track
Automatically start playing the first track after opening this activity.

Allow downloads
Controls whether the user will be able to download episodes to their device and listen to them offline. The download options will only be available (in the context menus, action bar, etc.) if this is enabled.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

Example Screenshot

Adding a Photo Gallery Activity

To add a Photo Gallery activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Photo Gallery from the list.

Now let's take a look at the Photo Gallery Activity settings.

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. It can be whatever you want but should probably describe what it is used for. For example: "Band Members".

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Here you can control the features that you want to enable or disable in your Photo Gallery Activity:

Show Index Page?
Whether or not your activity will include an index page. The index page is a scrollable grid containing thumbnail versions of all of your photos.

Show Descriptions?
Whether or not the descriptions of your photos will be displayed.

Enable Set-picture-as?
Whether or not the user has the ability to set the photo as their device’s wallpaper, contact photo, or any other available system dependent option.

Enable Photo Sharing?
Whether or not the end users of your application will be able to share your photos. Photos will be shared using the share intent and available to applications that support that intent (e.g. Gmail, Twitter, Facebook)

Save Your Settings

Once you're finished entering the above information, click on the 'Save Changes' button to create your Photo Gallery activity, and begin the process of adding photos.

Photo

Here you can upload a photo that will appear in your Photo Gallery Activity. Supported image formats: PNG and JPG. Click the 'Browse' button to select an image file to upload.

Details

Title
The title that will be displayed in the photo's description area.

Description
A short description of the photo that will be displayed in the photo's description area.

Position
This is a relative index that controls the order of the photos in your Photo Gallery activity. The position will effect where your activity is displayed on the index and in the view pager. For more information on a similar setting please read: How to change the order of the icons on the dashboard

Contents

This area contains the list of photos added to this activity. You can edit their settings or delete them using their corresponding Edit and Delete buttons. To add additional photos, click the +Add Photo button.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

Adding a Phone Activity

To add a Phone activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Phone from the list.

Now let's take a look at the Phone Activity settings.

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard and navigation drawer. It can be whatever you want but should probably describe what it is used for. For our example "Call Us".

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

This activity type does not contain a user interface therefore these Toolbar settings do not apply. See the Activity Toolbar topic for descriptions of these settings.

Details

Phone Number
The telephone number that will be displayed in the phone dialer when the activity is selected. A variety of formats are supported, however we recommend you include the country code such as: 1-212-555-1234.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

Adding a PDF Activity

To add a PDF activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select PDF from the list.

Now let's take a look at the PDF Activity settings.

Settings

Activity Name
The name that you want to give your activity, this will appear on the dashboard and navigation drawer. It can be whatever you want but should probably describe what it is used for.

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

This activity type does not contain a user interface therefore these Toolbar settings do not apply. See the Activity Toolbar topic for descriptions of these settings.

Details

PDF File
The PDF document that you want to add to your app. The maximum file size is 15 MB. Click the 'Browse' button to select your PDF document to upload.

Note that this will add to the total size of your app -- if you're planning to publish your app in Google Play, be aware that Google Play only allows apps up to 100 MB in size.

In general you should try to keep your file sizes as small as possible.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

Adding a Map Activity

To add a Map activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Map from the list.

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. It can be whatever you want but should probably provide a general description of the map that you will be displaying. For example "Company Location".

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)

Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Location-Aware
This feature will let your users locate themselves on the map, show nearby locations, and get route or navigation directions. If enabled, a button will be shown allowing users to show their current location on the map (if available). Whenever the user selects a location marker, two links are provided on the information window below the description, "Show Route", and "Open Navigation". When "Show Route" is selected, a route is drawn from their current location to the selected location, along with informational markers that provide point-by-point directions. When "Open Navigation" is selected, the Google Navigation application is launched (if installed) to provide an alternate navigation interface. If for some reason these additional location-based features are not available, they will not be provided to the user.

When this feature is enabled, the app will request permission from the user to allow usage of location providers on the device such as GPS, cell tower, or WiFi access points when when installing the app.

Google Maps API Key

This is where you can enter your Google Maps Javascript API key to authorize your use of the Google Maps Javascript API.

If you do not enter an API key, your app will display a low-resolution map with a watermark on it as of June 11, 2018:

At that time, keyless calls to the Maps JavaScript API and Street View API will return low-resolution maps watermarked with “for development purposes only.” - Google product and pricing changes

Note: Beginning June 11, 2018, all Google Maps access needs to be authenticated, and Google Maps usage above certain thresholds are subject to fees from Google. You will need to enable billing in the Google Cloud Console (and register a credit card) In order to use Google Maps within your app. See here for pricing. Map views are subject to the limits for "Dynamic Maps." The use of map markers is subject to the limits for "Geolocation." If navigation is enabled, that is subject to the limits for "Directions."

Please be aware that map access is no longer a free service from Google. If you do not want to incur any fees, make sure you set appropriate daily quotas in the Google Cloud Console, or do not use the Map activity.

To generate an API key, you will need to select a project in the Google Cloud Console and create a Credential for it. The type of credential you need is an "API key."

See Setting up API keys in the Google Cloud Console Help documentation.

Once you've generated an API key, you may want to restrict access by adding one or more "HTTP referrers (websites)" application restrictions (one for each Andromo Map activity you use). You can also set an "API restriction" on the key to only enable it for the "Maps JavaScript API" if you wish.

HTTP Referrer

This is the value you can enter as an "HTTP referrer (websites) API key restriction" within the Google Cloud Console to help secure access to your Google Maps API Key. Although this is not required (the map will work without it), it is a good idea to help protect your API key access a little bit.

To enter this value in the Cloud console, navigate to your API key, and add the value to the list of "Application restrictions" by selecting the "HTTP referrers (websites)" option. (If you have multiple maps using the same API key, you will need to add the appropriate HTTP referrer path for each Andromo activity to the list.)

Note: only an "HTTP referrer" restriction will work. You cannot use an "Android apps" restriction at this time.

See: Best practices for securely using API keys in Google's Cloud Platform documentation.

Save Your Settings

Once you're finished entering the above information, click on the 'Save Changes' button to create your Map activity, and begin the process of adding locations to your map.

Location

Now that you've created your Map activity, the next step is to start adding points to your map that will be shown as markers. Each location marker contains the settings below.

Title
The main heading (in bold) for the information window that pops up when the user selects this location marker on your map. A good choice would be something like your company name. To prevent this text from wrapping, it's best to keep it shorter than approx. 45 characters in length. Aside from wrapping, you will also want to limit this text to approx. 80 characters.

Description
The description for the marker's information window that is shown underneath the Title. Usually this will be contact details such as the address and phone number. The information window will safely accommodate 2 lines of visible text of approx. 80 characters in length. Lengths beyond this will cause the "Show Route" and "Open Navigation" links to be cut off (if you have the Location-Aware feature enabled).

Tip: You can force the description to show on two lines by adding the HTML line break format code

at the end of your first line. e.g. My first line

My second line

Address
The full address of the location you want to add, such as '505 North Michigan Ave, Chicago, IL 60611, USA'. This information is used to find the latitude and longitude values for the location point. If you already know the latitude and longitude values, you can leave this field blank and enter the coordinates directly.

Latitude
If you know the latitude value for your address, enter it here (e.g. 41.8913202). Otherwise, leave this blank.

Longitude
If you know the longitude value for your address, enter it here (e.g. -87.6240515). Otherwise, leave this blank.

Locations

When you're finished entering the location's information, click on the 'Save Changes' button to finish adding the location to the map. After saving the location, you can verify that it is correct by looking at its location on the Map Preview. If it's incorrect, you can click the Edit button to change its location settings by providing a more accurate address or specific latitude/longitude values.

Address
The list of locations you've added to the activity. You can edit their settings or delete it using its corresponding Edit and Delete buttons.

Add Map Location
There's no limit to the amount of locations you can add. To add additional locations to the Map activity, click on the +Add Map Location button. Repeat this step for each new location you want to add.

Map Preview
A map preview containing the markers of the locations you've added so far to this activity.

 Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

How it Looks

Below are examples of a Map activity containing a couple locations and with Location-Aware enabled:

Initial view of the activity:

A location point's information window after being selected by the user:

After the user has shown their current location and selected a location:

After the user has selected the Show Route link in the information window and selected a direction point:

NOTE: For best results, we recommend adding the following HTML 'meta' tag to the document 'head' of each of your HTML files:
<head> <meta name="viewport" content="width=device-width, user-scalable=no" /></head>

You can find detailed information regarding this tag under Using Viewport Metadata in the Android Developers Guide.

Content can be as simple as a single HTML file, or a complex directory structure of files and related image resources. Once you've composed what you want to show, simply zip the content using your favorite zip utility and upload the resulting file.

Benefits

• Does not require a web server to be hosting your web content.
• Since the content is embedded in the application, it's only visible to the people using the application.
• Content can be as simple as a single html page, or an index containing links to other pages, images etc.
• It will be more responsive since the files will be loaded from the application on the device instead of having to be downloaded.

  ---

 Drawbacks

• This does require some basic knowledge of HTML content creation, and basic usage of a zip utility.
• Since the files are built into the application, their content will not change after publishing the application. Therefore if any changes are required, the application would need to be published again.

  ---

Adding an HTML Archive Activity

To add an HTML Archive activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select HTML Archive from the list.

Now let's take a look at the HTML Archive Activity settings.

Settings

The following settings are available for this activity.

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe what you will be displaying.

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

HTML Archive File
The .zip file containing your HTML file(s) and related assets. Click on the 'Browse' button to select the zip file (.zip) to upload.

NOTE: For best results, we recommend adding the following HTML 'meta' tag to the document 'head' of each of your HTML files:
<head> <meta name="viewport" content="width=device-width, user-scalable=no" /></head>

You can find detailed information regarding this tag under Using Viewport Metadata in the Android Developers Guide.

Creating the zip file requires that you have some type of zip utility installed on your system that creates a file with a .zip extension. When you're ready to upload, select all of the files and folders required for your HTML pages and add them to create a zip archive file. The first page to be shown is referred to as the HTML Index Page ( such as 'index.html'). It needs to be located in the root of the .zip file (not in a subfolder). In order for files to be referenced correctly, you must also ensure that each referenced file uses relative paths (relative to the root of the zip file i.e. where your HTML Index Page is located). There are many free zip programs available online as well as resources for creating HTML pages and websites.

For more detailed instructions, see the knowledge base article, How to Create an HTML Archive ZIP.

HTML Index Page
This is the name of the file in the root of the .zip file that you want to show when this activity is viewed. This file must be located in the root of the .zip file (not in a folder). A common name for such a file is 'index.html' (however can be named what you like).

For more detailed instructions, see the knowledge base article, How to Create an HTML Archive ZIP

Orientation
This setting allows you to force the activity to stay in a particular orientation. Leave this on 'Automatic' unless you absolutely need to lock the display orientation for some reason (like games etc.).

• Automatic - Switch orientations automatically (the normal behavior).
• Landscape - Lock this activity in landscape orientation.
• Portrait - Lock this activity in portrait orientation.

Banner ads

This controls which banner ad networks will be permitted on this activity when banner ads are enabled for the app.

You can choose whether to permit all ads, all ads except Google AdMob ads, or to prevent any ads from appearing in this activity at all.

Google does not permit AdMob ads to be shown alongside web content containing Google AdSense ads. Refer to the AdMob terms of use and content guidelines for details.

Enable Geolocation permissions
You can enable this option if any of the pages need access to HTML5 Geolocation features. When this feature is enabled, the appropriate permissions will be added to the app requesting access to their location.

Open links in external browser
You can enable this option to open external links outside of the app, within the default browser.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

Linking to Another Activity

The HTML Archive activity also allows you to open another activity from a link using the special URL format:

andromo://<<internal-activity-identifier>>

Each activity contains an internal unique identifier that can be referenced for opening it. You can find each activity's reference URL in the the section labelled "Activity URL" located below the activity's Example Screenshot. Each activity's settings can be accessed from the "Activities" tab, by clicking the desired activity name or icon, or by selecting "Edit" from its Action drop-down list.. It will appear as a value such as:

where "gallery25491" is the internal identifier for that particular activity. This value will be different for each activity in your project.

As an HTML hyperlink, this would be formatted as:

<a href="andromo://gallery25491">Visit Our Photo Gallery</a>

If you'd like to open the dashboard, you can specify the following:

andromo://dashboard

As an HTML hyperlink, this would be formatted as:

<a href="andromo://dashboard">Go Home</a>

It's also possible to reference a sub-page in an HTML Archive activity from another HTML Archive or Custom Page. For example, if you have a page in your archive that is within a sub-folder, such as /pages/mypage.html, you could reference it as:

<a href="andromo://html15407/pages/mypage.html">Go to my sub-page</a>

where andromo://html15407 references the activity, and /pages/mypage.html represents the page's path from the root of the archive.

Example

Below is how a finished activity would look given this sample .zip HTML archive.

Adding a Google Play Activity

To add a Google Play activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Google Play from the list.

Now let's take a look at the Google Play Activity settings.

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard and navigation drawer. It can be whatever you want but should probably describe what it is used for. For our example "My Other Apps".

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using its Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

This activity type does not contain a user interface therefore these Toolbar settings do not apply. See the Activity Toolbar topic for descriptions of these settings.

Details

Google Play URL
The URL of a specific application, or a search query you want to perform in Google Play. See the Examples section below for samples of its usage.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of its usage, refer to the topic Linking to Another Activity.

Examples

Linking to Specific Apps - Links to specific apps have the following form, where <package_name> is the package name of that specific app:

http://play.google.com/store/apps/details?id=<package_name>

As an example, a real application would look like the following, where the package name is 'com.andromo.dev6.app23495':

http://play.google.com/store/apps/details?id=com.andromo.dev6.app23495

Showing all of your Apps - To show all of your apps, you would provide a search using your Google Play 'publisher name'. This type of link has the following form, where <publisher_name> is your publisher's name in Google Play. The publisher name of apps is usually shown below the app name in Google Play:

http://play.google.com/store/search?q=pub:<publisher_name>

Using a General Search Query - If you want to create a link that uses a general search query in Google Play, the link should have the following form, where <query> is the search query you want to perform:

http://play.google.com/store/search?q=<query>

For example, you could provide a search for any apps that contain the keyword 'hockey' using the following:

http://play.google.com/store/search?q=hockey

Example Screenshot

Adding a Flickr Gallery Activity

To add a Flickr Gallery activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Flickr from the list.

Settings

Activity Name
The name that you want to give to your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe what you will be displaying.

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Display Images By
This option controls whether the Flickr User ID value or the Flickr Data Feed URL setting will be used.

Flickr User ID
If you are displaying photos by Flickr User ID, this value should be set to the flickr ID number of the user whose photos you want to display. See the Flickr Photo Feeds article for information about finding your Flickr User ID.

Tip: use http://idgettr.com/ to get the ID from a photostream URL.

Flickr Data Feed URL
If you are displaying photos by Flickr Data Feed URL, this value should be set to the full URL of the flickr feed that you wish to display. For example:

http://api.flickr.com/services/feeds/photos_public.gne?format=rss_200

For more information on creating Flickr Feed URLs please see the Flickr Services Documentation. The preferred feed format is rss_200.

Item Style
The item style you want to use for the index page of the Flickr content. Choose from styles such as cards, grids, and lists.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

What the Flickr Gallery Activity Contains

By default the Flickr Gallery Activity contains a scrollable grid of thumbnails which is populated when the app queries the feed. When the user clicks on one of the thumbnails, they will be able to view the full sized image and be able to swipe horizontally to see the next or previous photo. If you'd like something different than a grid, you can choose from a variety of different Item Styles for the index page.

The image view contains other features such as setting the wallpaper, sharing options, and the visibility of the description. Below are some examples of this activity:

Adding a Facebook Activity

To add a Facebook activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Facebook from the list.

Now let's take a look at the Facebook Activity settings.

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. It can be whatever you want but should describe what it is.

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Facebook Page
Your Facebook page name. This value should only be the part that comes after http://www.facebook.com/, not the full URL. For example, you could enter 'andromorocks' here to add our Facebook page to your app.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.

Example

Here is an example of Andromo's Facebook page:

Adding an Email Activity

To add an Email activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Email from the list.

Now let's take a look at the Email Activity settings.

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard and navigation drawer. It can be whatever you want but should probably describe what it is used for. For our example "Email Us".

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and the navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images  topic for descriptions of these settings.

Toolbar

This activity type does not contain a user interface therefore these Toolbar settings do not apply. See the Activity Toolbar  topic for descriptions of these settings.

Details

Email Address
The email address to send to. For example, sales@yourcompany.com.

Subject
The subject line for the email message. For example, 'Please send me information about your company'. This field is optional.

Body
The text you would like to appear in the email message. This field is optional.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity .

Adding a Custom Page Activity

To add a Custom Page activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Custom Page from the list.

Settings

The Custom Page activity has the following settings.

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe the page that you will be displaying. For example 'About Us', 'Biography', or 'Contact Information'.

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

This area contains an HTML editor that allows you to create formatted text that can include graphics, links etc. Simply choose the desired format or style, and start typing! Explore the editor menu for a wide variety of available options. You can press the "Source" button in the editor menu to view or edit the raw HTML source text if needed.

Orientation
This setting allows you to force the activity to stay in a particular orientation. Leave this on 'Automatic' unless you absolutely need to lock the display orientation for some reason (like games etc.).

• Automatic - Switch orientations automatically (the normal behavior).
• Landscape - Lock this activity in landscape orientation.
• Portrait - Lock this activity in portrait orientation.

Enable Geolocation permissions
You can enable this option if the page needs access to HTML5 Geolocation features. When this feature is enabled, the appropriate permissions will be added to the app requesting access to their location.

Open links in external browser
You can enable this option to open external links outside of the app, within the default browser.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity .

Linking to Another Activity
The Custom Page activity also allows you to open another activity from a link using the special URL format:

andromo://<<internal-activity-identifier>>

Each activity contains an internal unique identifier that can be referenced for opening it. You can find each activity's reference URL in the the section labelled "Activity URL" located below the activity's Example Screenshot. Each activity's settings can be accessed from the "Activities" tab, by clicking the desired activity name or icon, or by selecting "Edit" from its Action drop-down list. It will appear as a value such as:

where "custompage968701" is the internal identifier for that particular activity. This value will be different for each activity in your project.

As an HTML hyperlink, this would be formatted as:

<a href="andromo://custompage968701">Visit Our Custom Page</a>

You can view the Custom Page's HTML source by clicking the "Source" button in the editor.

If you'd like to open the dashboard, you can specify the following:

andromo://dashboard

As an HTML hyperlink, this would be formatted as:

<a href="andromo://dashboard">Go Home</a>

Example Screenshot

Adding a Contact Activity

To add a Contact activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Contact from the list.

Now let's take a look at the Contact Activity settings.

Settings

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. It can be whatever you want but should probably describe what it is used for. For example "Contact Us".

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

Title
This is used for the main heading. It can be your name, your company name or however you'd like to identify yourself. This value is optional.

Email Address
The contact email address to display. For example, sales@yourcompany.com. Users can press the icon to the right of the email address to initiate an email message using the end user's chosen email client. This value is optional.

Website URL
The URL of your personal or company website. For example, http://www.andromo.com. Users can press the icon to the right of the URL to open it in the Android browser. This value is optional.

Street Address
The street address for you or your company as you would like it to appear. For example:

505 North Michigan Ave,
Chicago, IL 60611
USA

Users can press the icon to the right of the address to show the location on a map. This value is optional.

Map Preview
A map preview of the location that was found for the given street address.

Phone (1-4)

Up to four optional contact telephone numbers for you or your company. A variety of formats are supported, however we recommend you include the country code such as: 1-212-555-1234. Users can press the icon to the right of each displayed telephone number to open it in the phone dialer. Each telephone number is optional.

Each telephone number has a corresponding type label. If one of the available types doesn't describe your number, you can select 'OTHER/CUSTOM' to specify a custom label.

Additional Details

Notes
The text for any additional information you'd like to show at the bottom of the page such as hours of operation, where to park, etc. This text area also supports the addition of the following HTML markup tags, <b>, <i>, <u>. Text containing URLs, email addresses, and telephone numbers will also be automatically converted to hyperlinks. This value is optional.

Legacy Images

This area may contain links to images that were used in Andromo v4 that are no longer used in this activity. You can use these links to download your original images if needed. The Contact activity's "Header Image" has been replaced by the "Feature Image".

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.