Basic App Information

App Name
The App Name is the name that will be shown on the action bar on top of the dashboard and underneath your app icon. Below is an example using the App Name "Redline News."

App Version
The version number allows you to keep track of releases of your app. Once you release your app to the public you will want to increment this version number each time you distribute a new version (1.0.0, 1.0.1 etc.). If your app is in Google Play, this will let people know that a new version is available.

Target Market
Use this setting in order to build a version of your app that will target a specific marketplace. The setting controls destination links for Google Play activities, PDF dependencies, share text, etc. so they point to either Google Play or the Amazon Appstore. More information can be found in the Making Kindle Fire apps with Andromo knowledge base article.

• Google Play: Android Phones and Tablets – Select this when you are building your app for distribution in Google Play. Share links and Google Play activities will always use Google Play links.
• Amazon Appstore: Kindle Fire and Kindle Fire HD – Select this when you are building your app for distribution through the Amazon Appstore. Share links and Google Play activities will use Amazon Appstore links. Note: This must be selected for approval in the Amazon Appstore.
• Samsung Apps: Android Galaxy devices – Select this when you are building your app for distribution through the Samsung Apps app store. Share links and Google Play activities will use Samsung Apps links. Note: The Samsung Apps store only allows deep linking using package names, the “Showing all of your Apps” and "Using a General Search Query" Google Play Activity options are not supported when targeting Samsung apps.

Category
This describes what category your app falls into. Choose the category name that best describes the content in your app.

Package Name
This allows you to select which default package name will be used for the app.

Switching between the standard and alternate package names can be useful if you want to build a second version of your app with small modifications -- for example, an ad-free version of your app. It can also be useful if you need to relaunch your project as a "new" app in Google Play, with a different package name.

What is a package name?
The package name is a string of text that serves as a unique identifier for the app. For example, the package name is used in the URL when linking to an app in Google Play.

Each app in Google Play must have its own package name. Once an app has been uploaded to Google Play, its package name is "locked in" forever -- you will always need to use that same package name to update the app, and no other app will be able to use that package name.

If you changed the package name and rebuilt the app, Google Play would see it as a different app, because of the package name.

When you start an Andromo project, two unique package names are generated for you. The default package names begin with either "com.andromo" or "net.andromo" followed by a unique developer id and project id.

You can override the default package names if you are on the Professional subscription plan:

Professional Features

This section contains professional features. They can only be used if you have a Professional subscription.

Custom Package Name
Only available with a Professional subscription.

WARNING: Leave this blank unless you are 100% sure of what you are doing and why you are doing it.

Anything you enter will be used as the package name for your Android app. More information on this setting can be found in the package section of the Android Manifest documentation:

A full Java-language-style package name for the application. The name should be unique. The name may
contain uppercase or lowercase letters ('A' through 'Z'), numbers, and underscores ('_'). However, individual
package name parts may only start with letters.

To avoid conflicts with other developers, you should use Internet domain ownership as the basis for your
package names (in reverse). For example, applications published by Google start with com.google. You
should also never use the com.example namespace when publishing your applications.

Caution: Once you publish your application, you cannot change the package name. The package name
defines your application's identity, so if you change it, then it is considered to be a different application
and users of the previous version cannot update to the new version.

It is not necessary to change the package name, and most users will never see the package name. However if you want to change your package name to follow package naming conventions or change it for a customer you can.

You also must avoid reserved Java keywords when creating your package name. You can find a list of these in the Java Language Keywords topic. If your package name includes any of these, it will fail during the build process.

If you leave this field blank Andromo will use a default package name in this format:

com.andromo.devXXXX.appYYYY

Where XXXX is your User ID, and YYYY is the Project ID.

Note: If you change your package name while you have a Professional subscription and then let your Professional subscription expire, you will not be able to update your app in Google Play, as the package name will revert to the default. Change this value with care.

Show Customized Text on About Dialog
Only available with a Professional subscription.

Allows you to show custom text that will appear on the About dialog, which is accessible from the overflow menu on the app bar (in the top right corner of the screen).

Enabling this option displays the About Dialog Text field where you can enter the custom dialog text.

About Dialog Text
The text you want to show on the About dialog. This can be useful for showing simple instructions, listing credits for the content you've used, or describing the changes in the latest version of your app.

This text supports some very basic HTML markup: <b> for bold, <i> for italic, and <a> for hyperlinks. (No other HTML is supported.)

Note: the user will be able to scroll the text if you enter more text than will fit on the About dialog at once.

 License Agreement

Show License Agreement
Allows you to show a EULA to your users that they must accept before running your app. The dialog is shown when the user launches your app for the first time. If the user declines, the app with exit. See example screenshot below.

License Title
The title to show on the license agreement dialog.

License Text
The text you want to show on the license agreement dialog.

This text supports some very basic HTML markup: <b> for bold, <i> for italic, and <a> for hyperlinks. (No other HTML is supported.)

Example License Dialog
Below is an example of how the dialog looks with some sample license text:

Launch Notice (EU User Consent Notice)

Show Launch Notice
Allows you to show a one-time notice the first time your app is launched. You can choose whether to show the notice anywhere in the world, or only within countries that are part of the European Union where an "EU Cookie Notice" needs to be shown.

You should use this to comply with EU privacy laws which require that you get consent or inform your users about any data collection, sharing, or usage that takes place within your app. See: EU User Consent.

The Launch Notice dialog is shown when the user launches your app for the first time. If Show License Agreement is enabled, the launch notice will be shown after the license agreement has been accepted.

Notice Title
The title to show on the launch notice dialog.

Notice Text
The text you want to show on the launch notice dialog.

This text supports some very basic HTML markup: <b> for bold, <i> for italic, and <a> for hyperlinks. (No other HTML is supported.)

European Union countries only (uncheck for Worldwide)

Allows you to restrict the launch notice to only be shown in countries that are part of the European Union where EU User Consent is required. If this option is unchecked, the launch notice dialog will be shown anywhere in the world.

The app will attempt to determine the user's country by using one of these methods, in the following order:

1. If it is a GSM phone, it will use the MCC reported by the mobile network (cell phone service provider).
2. If that fails, and an internet connection is available, it will perform an IP lookup.
3. If that fails, it will make an assumption based on the device language settings.

The check for the end user's country will not be repeated; once a country has been determined, that country will be used in the future, until the app is uninstalled or its data cache is cleared.

Example Launch Notice
Below is an example of how the dialog looks with some sample notice text:

App Icon

The app icon allows users to easily identify your app on their phone/tablet in order to run it. It's shown in various places, such as their apps list, and when they're managing their applications. See example images below for the "Redline News" app icon.

<img src="/help/assets/1f44e78dbb7a59f7a43b8fc6b59f21b4645929a2/app_info_home_screen_framed_normal.png" width="40%" height="40%">

<img src="/help/assets/9785495642177d861cf8fc55e8a8c5a1ea0bcee8/app_info_app_list_framed_normal.png" width="40%" height="40%">

App Colors

Note: These colors do not affect Website, Custom Page, or HTML Archive content. Some application elements may contain their own color settings which override these settings.

Backgrounds
The color that will be used as the background in your app for areas that don't contain their own color settings. For example, this color is used as the background color of the RSS feed item list (see example image below).

Headings
The color that will be used for any heading text in your app for areas that don't contain their own color settings. For example, this color is used as the heading text for an RSS feed item (see example image below).

Primary Text
The color that will be used for any body text in your app for areas that don't contain their own color settings. For example, this color is used for an RSS feed item's text (see example image below).

Secondary Text
The color that will be used for any text elements that require a secondary text style in your app for areas that don't contain their own color settings.

Dates
The color that will be used for any dates in your app that don't contain their own color settings. For example, this color is used for the dates of an RSS feed item (see example image below).

Action Bar

Action Bar Theme
When choosing a theme, you should choose Light or Light with Dark Action Bar if you plan to pick bright background colors, otherwise you should choose Dark. The base theme is used for tons of little bits in your app as well as the colors in the action bar, so you don't have to select them all yourself. Choose from the following options:

• Light - The Light Android system theme. Choose this theme if you're using bright background colors and want a light grey action bar and menu, with black text.
• Dark - The Dark Android system theme. This theme uses a black action bar and menu, with white text.
• Light with Dark Action Bar - A combination of the Light and Dark system themes. This theme contains light elements for things like backgrounds, but displays a dark action bar.
• Upload Custom Theme File - This option allows you to upload a custom theme file instead of using the default Light or Dark themes. You can create this file using the Android Action Bar Style Generator. Andromo requires that "Sherlock" be selected for it's "Style compatibility" setting. For more information about creating the style file, see the Action Bar Style Generator knowledge base article.

Action Bar Style
The style of the action bar when using one of the default system themes - Light, Dark, or Light with Dark Action Bar.
Note: If you're using a custom theme file, the equivalent setting is defined as the "Action bar style" when creating it.

• Solid - Shows a solid action bar.
• Transparent- Shows a transparent style action bar. This option looks similar to solid, but displays a colored key line.

Action Bar Mode
The text mode to display on the action bar. Choose from:

• No text or activity navigation - Shows no application or activity title text on the action bar. This option does not contain a navigation dropdown.
• Show application name (no navigation) - Shows the application name title text on the action bar for the dashboard, and all activities. This option does not contain a navigation dropdown.
• Show activity name (full navigation) - Shows the application or activity name title text on the action bar. This option includes the navigation dropdown.

Override theme colors
Enabling this setting allows you to set the text color shown in the action bar.

Action Bar Logo Image
Show a logo image in the action bar instead of the application icon. To maintain compatibility between various screen sizes, we recommend a maximum width of 550 pixels (when not showing action bar text), and a general height of 60 pixels. The image will scale to fit the height of the action bar, so you can experiment with other sizes to suit your logo, and desired title text visibility.

This is where you build your Android application when you are ready. When you press the green Build My App button, Andromo will build your Android Package File (APK) and then email you when the build has finished. After downloading your APK you may want to install your application on a mobile device or test your application without a mobile device

Your app's email download link expires after 24 hours, however you can always download your app directly from Andromo by going to "My Projects", locating your project in the list, and selecting "Download" from the "Action" dropdown.

Note: Building your app can take some time, depending on how busy our servers are. It's not unusual for the build to take as little as five minutes, but it can take an hour on a very busy day. Please check your inbox (and spam folder) for emails from andromo@andromo.com.

Google App Analytics

Google Analytics lets you anonymously track user activity within your app. Using the Google Analytics service, you can view statistics like which activities your users visit, how much time they spend there, and even often they launch your app. This can give you valuable insight into how your users interact with your apps, helping you make your apps better.

Note: As of version 3.0.6 of Andromo, you need to use an App analytics code instead of a Web one (your old Web analytics UA-XXXXX-YY code will no longer work). If you were using analytics prior to 3.0.6, you will need to generate a new App ID and update the settings in your project.

See How to use Google Analytics in your Application for full instructions on using Google Analytics in your project.

AirBop Push Message Notifications

AirBop Push notifications allow you to send information to the users of your apps, even when the apps aren't running. They're an incredibly powerful marketing tool -- if used properly and judiciously. For complete details about integrating push notifications into your app, please see the AirBop Push Message Notifications knowledge base article.

Ad Formats

Banner Ads
Banner ads are small rectangular ads that generate revenue when they're clicked. They are usually shown at the bottom of the screen (but may be shown at the top in some activity types). These ads are relatively popular with users because they don't interfere very much with their use of the app.

If you choose to show more than one, an ad network will be selected randomly by the app each time it needs to show an activity. (Each banner ad network you select has an equal chance of being chosen whenever an activity is shown.)

Remember to click Save Changes at the bottom of the page so the changes are applied to your project, and then build a new version of your app and distribute it to your users.

Note: Banner ads will appear on your app's dashboard by default. If you don't want ads on the dashboard, you can disable the feature by unchecking the "Show Banne Ads on Dashboard" checkbox on your project's Dashboard tab.

Interstitial Ads
Interstitial ads are large ads that appear 'between' activities in your app. Since they really grab the user's attention, they can be more effective than banner ads at generating clicks. However, you don't want to show them too frequently, or you may risk annoying some of your users.

AdMob

AdMob banner ads are cost per click (CPC), which generate a little revenue every time the user clicks on an ad. See the article Setting Up AdMob Ads for further details about setting up your AdMob account.

AdMob Banner Ads
To enable AdMob banner ads in your app, check the box labelled AdMob Banner Ads, and copy your app's Ad Unit ID for banners from your AdMob account into the AdMob Ad Unit ID (Banner) field.

AdMob Interstitial Ads
To enable AdMob interstitial ads in your app, check the box labelled AdMob Interstitial Ads, and copy your app's interstitial Ad Unit ID from your AdMob account into the AdMob Ad Unit ID (Interstitial) field.

AdMob App ID
The AdMob App ID for your app. This setting is optional however if provided improves initialization time. To find your app ID, click the App management option under the settings dropdown (located in the upper right-hand corner) on the AdMob account page. App IDs have the form ca-app-pub-XXXXXXXXXXXXXXXX~NNNNNNNNNN.

Amazon Mobile Ads

Amazon Mobile Ads is an ad network that delivers high-quality ads on Amazon Kindle tablets, as well as Android phones and tablets. See Setting Up Amazon Mobile Ads for further details about setting up your account.

Amazon Banner Ads
To enable Amazon Mobile Ad banners in your app, check the box labelled Amazon Banner Ads and copy your Amazon Application Key from your app's Mobile Ads tab in your Amazon Mobile App Distribution account into the Amazon Application Key (Banner) field.

Amazon Interstitial Ads
To enable Amazon interstitial ads in your app, check the box labelled Amazon Interstitial Ads, and copy your Amazon Application Key from your app's Mobile Ads tab in your Amazon Mobile App Distribution account into the Amazon Application Key (Interstitial) field.

AppBrain

See the article Setting Up AppBrain Ads for further details about setting up your account.

AppBrain Interstitial Ads
To enable AppBrain interstitial ads in your app, check the box labelled AppBrain Interstitial Ads.

AppLovin

AppLovin ads are cost-per-action (CPA), which generate revenue when the end user performs some action such as installing an app. See the article Setting Up AppLovin Ads for further details about setting up your account.

AppLovin Interstitial Ads
To enable AppLovin interstitial ads in your app, check the box labelled AppLovin Interstitial Ads, and copy your AppLovin Key from your AppLovin account into the AppLovin SDK Key field.

Facebook Audience Network

Facebook's Audience Network helps you monetize your app by tapping into Facebook's powerful advertising platform which includes all of the people-based targeting, measurement, and real-time optimization that's used on Facebook itself. See the article Setting Up Facebook Audience Network Ads for further details about setting up your Facebook developer account.

Facebook Banner Ads
To enable Facebook Audience Network banner ads in your app, check the box labeled Facebook Banner Ads, and copy your app's ad Placement ID for banners from your Facebook developer account into the Facebook Placement ID (Banner) field.

Facebook Interstitial Ads
To enable Facebook Audience Network interstitial ads in your app, check the box labelled Facebook Interstitial Ads, and copy your app's interstitial ad Placement ID from your Facebook developer account into the Facebook Placement ID (Interstitial) field.

StartApp

StartApp ads are either cost per click (CPC), or cost-per-action (CPA), which generate revenue when the end user either clicks on an add or performs some action such as installing an app. See the article Setting Up StartApp Ads for further details about setting up your account.

StartApp Banner Ads
To enable StartApp banner ads in your app, check the box labelled StartApp Banner Ads, and copy your StartApp Developer ID and StartApp App ID from your StartApp account into their corresponding fields.

StartApp Interstitial Ads
To enable StartApp interstitial ads in your app, check the box labelled StartApp Interstitials, and copy your StartApp Developer ID and StartApp App ID from your StartApp account into their corresponding fields (the same IDs are used for both banners and interstitials).

Interstitial Ad Settings

Time between Ads
This setting controls the duration between interstitial ad impressions. Try to choose an appropriate value based on how often you think your users would want to see an interstitial ad. Keep in mind that shorter times aren't always better -- setting this value too low may cause some users to uninstall your app.

Require several interactions before showing an interstitial ad
This setting controls whether or not the user has to interact with your app more than once to see an interstitial ad. Enabling this option will add a bit of randomness to when the interstitial ad is shown so that it does not always display when the first activity is selected.

Remember to click Save Changes at the bottom of the page so the changes are applied to your project, and then build a new version of your app and distribute it to your users.

Activites come in a variety of types and are composed of one or more screens that users can navigate through.

Add an Activity

The first step is to choose the type of activity you want to add based on the type of information you would like to show. More activity types will be added in the future, but at present you can choose from the following activity types by clicking the 'Add an Activity' button and selecting the desired activity type from the list. These settings can be found on the 'Activities' tab while editing your project:

About

The About activity is used to display information about yourself, your company and/or your app. You can show information such as your name, title, description, and links to various sites where your users can find out more. For more information, see About Activity.

Audio Player

The Audio Activity allows you to play audio files within your Andromo application. For more information, see Audio Player Activity.

Contact

The Contact Activity is designed to make it easy for users of your app to get in touch with you. You can decide what contact details to make available such as you Phone, Email, Website and Address - each being interactive! For more information, see Contact Activity.

Custom Page

The Custom Page activity allows you to easily create stylish pages with text, graphics, tables and forms. It's perfect for creating pages like 'About Us', 'Biography', 'Contact Information' etc. For more information, see Custom Activity.

Email

The Email activity is used to initiate an email message using the end user's chosen email client with a specific email address, and optional subject and text. This allows users to initiate an email with a single click. For more information, see Email Activity.

Facebook

The Facebook activity lets you easily embed a mobile-friendly Facebook page into your app. For more information, see Facebook Activity.

Flickr

The Flickr Image Gallery Activity allows you to take your photos from flickr and display them in your Android application. For information on creating flickr feed URLs please see the Flickr Services Documentation and the Flickr Photo Feeds knowledge base article. The preferred feed format is rss_200. For more information, see Flickr Activity.

Google Play

The Google Play activity is used to create an icon on the dashboard that points to an application, or list of applications on Google Play (previously known as the Android Market). This allows you to do things such as provide easy access to a paid version of your app, or show other apps you've created. For more information, see Google Play Activity.

HTML Archive
 

The HTML Archive Activity allows you to display web content (HTML files) by storing HTML files within the application so it can be read directly from the device. This allows you to provide previously created content to your users that 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. For more information, see HTML Archive Activity.

Map

The Map Activity lets you display your locations on an interactive map. Your users can then see your address, nearby locations, and even get directions and navigation to your business. For more information, see Map Activity.

PDF

The PDF activity is used to quickly and easily embed a PDF document into your Android application. Your PDF document will be opened external to your app in a supported installed viewer (Adobe Reader app recommended). If the user does not have the Adobe Reader app, or something similar installed, they will be prompted to install the app via the Google Play app store. For more information, see PDF Activity.

Phone

The Phone activity is used to display the phone dialer (if available) filled in with a specific telephone number. This allows users to contact you with a single click. For more information, see Phone Activity.

Photo Gallery

The Photo Gallery Activity is used to add a photo gallery to your app. For more information, see Photo Gallery Activity.

Podcast

The Podcast Activity displays an iTunes Podcast RSS 2.0 feed in your app. It supports both streaming over the network and downloading episodes for playback offline. For more information, see Podcast Activity.

RSS Feed

The RSS Feed activity allows you to take an existing web feed from the web and display it in your application, making it easy for mobile users to browse and read. Most websites and blogs publish feeds that you can use, including sites like Twitter, Blogger etc. For more information, see RSS Feed Activity.

SHOUTcast Radio

The Radio activity allows you to play streaming audio from internet radio stations in your application. It's similar to the Audio activity, with additional support for SHOUTcast and Icecast streaming audio. For more information, see Radio Activity.

Twitter

The Twitter Activity allows you to display one of three different twitter timelines. You can choose to: display a specific twitter user's timeline, a timeline from a list, or a timeline based on a search of the most recent public tweets. For more information, see Twitter Activity.

Website

The Website activity is used to display the contents of a website in your application. It is one of the simplest activities, yet it's ability to display web content makes it very powerful. All you need is the URL of a website, and the user will be able to navigate to it simply by pressing its icon on your dashboard. For more information, see Website Activity.

YouTube

The YouTube Activity allows you to take video content from YouTube and display it in your Android application. For more information, see YouTube Activity.

Changing the Order of Activities

In order for your application to look its best, you'll probably want at least 4 or more activities. You can add as many as you want and order them however you please. For more information on the activity order, see How to change the order of the icons on the dashboard.

The dashboard is your 'home' screen (activity), where users can navigate through all the activities (features) in your app. If you've chosen "Show dashboard" as the Startup Mode, this is what your end users will see the first time they launch your application.

The dashboard will display items representing each activity that you have added to your application. The items are constructed using the name of each activity, an optional subtitle and description, and the image or drawer icon that you assigned to it. These settings are configured on the individual activity's properties page.

Startup

Startup Mode
The startup mode controls which initial screen ('home' screen) will be shown when the user launches your app.

• Show dashboard - Show the dashboard when launching the app.
• Show first activity (no dashboard) - Show the activity with the lowest "Position" from the activity list (Activities tab).

  ---

Dashboard Settings

Dashboard Name
The name that you want to use to represent the dashboard on the Navigation Drawer. For example, "Home".

Item Style
The item style you want to use to represent the activities in your app. Choose from styles such as cards, grids, and lists.

You can see screenshots of all the dashboard item styles to help you pick your favorite look.

Show Banner Ads on Dashboard
This setting controls whether or not banner ads will be shown at the bottom of the dashboard when Banner Ads are enabled. You can configure Banner Ads on the Monetization tab of your Andromo project.

Show Social Sharing Button
This setting controls whether or not a share icon will be shown on the dashboard. This option enables your users to share a link to your app in the chosen app store.

Note: The format of the generated link used to share your app is automatically converted to the proper location based on the chosen "Target Market" setting on your project's "Settings" tab. See the Settings article for more information about that setting.

Dashboard Theme

Theme Mode

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

 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 dashboard. The primary color is generally your app's "branding" color. It is used for toolbar backgrounds and to represent activities when images aren't provided.

Accent Color
The accent color you want to use for the dashboard. 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 dashboard 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.

Dashboard Images

This section allows you to provide the images to show on the dashboard and that will be used to represent it.

Background Image
The background image is an optional image that can be shown behind the dashboard's content.

• None - Don't use a background image.
• Inherit from theme - Use the global theme's background image.
• Custom - Enables the Custom Background Image Settings section of settings allowing you to upload a background image for the dashboard.

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 dashboard'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 global theme's feature image.
• Custom - Enables the Custom Feature Image Settings section of settings allowing you to upload a feature image for the dashboard.

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

• 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

• 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.
• 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 dashboard on the navigation drawer.

Dashboard Toolbar

Toolbar Mode

• Global - Use the Global toolbar settings from the Theme tab of your project.
• Custom - Enables the Custom Toolbar Settings section of settings allowing you to customize the toolbar style for the dashboard.

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 dashboard 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 dashboard content.
• Auto hiding - Automatically hide the toolbar when scrolling dashboard content.

Show Advanced Settings
Shows or hides the Advanced Toolbar Settings for the selected style containing settings such as the Background Type, Background Color, 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 dashboard's feature image as the toolbar background.
• Feature image morphing to color (Expanded Toolbar style only) - Morph the dashboard'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).

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."

Navigation Drawer

Enable Navigation Drawer
Allows you to enable or disable the navigation drawer for your app.

Start App with Drawer Open
Whether or not the navigation drawer will be in an open state when starting the app for the first time.

Title
The title to show on the navigation drawer.

Subtitle
The subtitle to show on the navigation drawer.

Upload a Header Image
Allows you to upload a header image for the navigation drawer. 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.

Example Navigation Drawer Screenshot

Here's what the Navigation Drawer looks like when running on an Android device:

 Global Color Settings

Note: Some colors do not affect activity content containing HTML such as the Website, Custom Page, HTML Archive, or RSS feed details. Their colors are controlled via HTML.

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

Accent Color
The accent color you want to use for your application. 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 its 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 customize the 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 (ie. the area 'behind' cards).

Background Color
The color you want to use for the background of areas where text may be shown (ie. 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.

Global Image Settings

This section allows you to provide global image settings that can be inherited in your app.

Background Image
The background image is an optional image that can be shown behind the dashboard/activity's content. Background images are only supported on some activity types.

• None - Don't use a background image.
• Custom - Enables the Custom Background Image Settings section of settings allowing you to upload a global background image.

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
A feature image is an optional image that can be shown as the background of an activity's toolbar or at the top of the content (outside of the toolbar). It can also be used to represent the activity on a dashboard. These settings allow you to provide a global feature image to inherit in your app.

• None - Don't use a global feature image.
• Custom - Use a global feature image. Selecting this option enables the Custom Feature Image Settings section containing the settings to use for a global feature image.

Custom Feature Image Settings
The following settings are available when "Custom" is selected as the Feature Image.

Aspect Ratio
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 global 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 is another variation of a feature image that is designed to be shown in an area with an aspect ratio of 16:9. If provided, this image will be used when an item style requests it (e.g. for a Card style).

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

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

Upload a Wide Image
Allows you to upload a global wide 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.

Square Image
The square image is another variation of a feature image that is designed to be shown in an area that is square. If provided, this image will be used when an item style requests it (e.g. for a Grid style).

• None - Don't use a square image.
• Use wide image, cropped - Use the provided Wide image when a square image is needed in an item style.
• Use feature image, cropped - Use the provided Feature image when a square image is needed in an item style.
• Custom - Use a custom square image. Selecting this option enables the Custom Square Image Settings.

Custom Square Image Settings

Upload a Square Image
Allows you to upload a global square image (1:1 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, JPG or PNG format.

Global Toolbar Settings

Toolbar Style

• Standard - 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 - 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 - 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, 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).

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."

 Basic App Information

App Name
The App Name is the name that will be shown on the toolbar on top of the dashboard and underneath your app icon.

App Version
The version number allows you to keep track of releases of your app. Once you release your app to the public you will want to increment this version number each time you distribute a new version (1.0.0, 1.0.1 etc.). If your app is in Google Play, this will let people know that a new version is available.

Target Market
Use this setting in order to build a version of your app that will target a specific marketplace. The setting controls destination links for Google Play activities, PDF dependencies, share text, etc. so they point to either Google Play or the Amazon Appstore. More information can be found in the Making Kindle Fire apps with Andromo knowledge base article.

• Google Play: Android Phones and Tablets – Select this when you are building your app for distribution in Google Play. Share links and Google Play activities will always use Google Play links.
• Amazon Appstore: Kindle Fire and Kindle Fire HD – Select this when you are building your app for distribution through the Amazon Appstore. Share links and Google Play activities will use Amazon Appstore links. Note: This must be selected for approval in the Amazon Appstore. Note: AirBop is not supported on Amazon devices as they do not have the necessary Google Services installed. AirBop will be disabled in the app when the Target Market is set to Amazon Appstore.
• Samsung Apps: Android Galaxy devices – Select this when you are building your app for distribution through the Samsung Apps app store. Share links and Google Play activities will use Samsung Apps links. Note: The Samsung Apps store only allows deep linking using package names, the “Showing all of your Apps” and "Using a General Search Query" Google Play Activity options are not supported when targeting Samsung apps.

Category
This describes what category your app falls into. Choose the category name that best describes the content in your app.

Package Name
This allows you to select which default package name will be used for the app.

Switching between the standard and alternate package names can be useful if you want to build a second version of your app with small modifications -- for example, an ad-free version of your app. It can also be useful if you need to relaunch your project as a "new" app in Google Play, with a different package name.

What is a package name?
The package name is a string of text that serves as a unique identifier for the app. For example, the package name is used in the URL when linking to an app in Google Play.

Each app in Google Play must have its own package name. Once an app has been uploaded to Google Play, its package name is "locked in" forever -- you will always need to use that same package name to update the app, and no other app will be able to use that package name.

If you changed the package name and rebuilt the app, Google Play would see it as a different app, because of the package name.

When you start an Andromo project, two unique package names are generated for you. The default package names begin with either "com.andromo" or "net.andromo" followed by a unique developer id and project id.

You can override the default package names if you are on the Professional subscription plan. See the *Professional Features* section below for further information.

 App Icon

The app icon allows users to easily identify your app on their phone/tablet in order to run it. It's shown in various places, such as their apps list, and when they're managing their applications.

License Agreement

 Show License Agreement
Allows you to show a EULA to your users that they must accept before running your app. The dialog is shown when the user launches your app for the first time. If the user declines, the app with exit.

License Title
The title to show on the license agreement dialog.

License Text
The text you want to show on the license agreement dialog.

This text supports some very basic HTML markup: <b> for bold, <i> for italic, and <a> for hyperlinks. (No other HTML is supported.)

Launch Notice (EU User Consent Notice)

Show Launch Notice
Allows you to show a one-time notice the first time your app is launched. You can choose whether to show the notice anywhere in the world, or only within countries that are part of the European Union where an "EU Cookie Notice" needs to be shown.

You should use this to comply with EU privacy laws which require that you get consent or inform your users about any data collection, sharing, or usage that takes place within your app. See: EU User Consent.

The Launch Notice dialog is shown when the user launches your app for the first time. If *Show License Agreement* is enabled, the launch notice will be shown after the license agreement has been accepted.

Notice Title
The title to show on the launch notice dialog.

Notice Text
The text you want to show on the launch notice dialog.

This text supports some very basic HTML markup: <b> for bold, <i> for italic, and <a> for hyperlinks. (No other HTML is supported.)

European Union countries only (uncheck for Worldwide)

Allows you to restrict the launch notice to only be shown in countries that are part of the European Union where EU User Consent is required. If this option is unchecked, the launch notice dialog will be shown anywhere in the world.

The app will attempt to determine the user's country by using one of these methods, in the following order:

1. If it is a GSM phone, it will use the MCC reported by the mobile network (cell phone service provider).
2. If that fails, and an internet connection is available, it will perform an IP lookup.
3. If that fails, it will make an assumption based on the device language settings.

The check for the end user's country will not be repeated; once a country has been determined, that country will be used in the future, until the app is uninstalled or its data cache is cleared.

Professional Features

This section contains professional features. They can only be used if you have a Professional subscription.

Custom Package Name
Only available with a Professional subscription.

WARNING: Leave this blank unless you are 100% sure of what you are doing and why you are doing it.

Anything you enter will be used as the package name for your Android app. More information on this setting can be found in the package section of the Android Manifest documentation:

A full Java-language-style package name for the application. The name should be unique. The name may
contain uppercase or lowercase letters ('A' through 'Z'), numbers, and underscores ('_'). However, individual
package name parts may only start with letters. 

To avoid conflicts with other developers, you should use Internet domain ownership as the basis for your
package names (in reverse). For example, applications published by Google start with com.google. You
should also never use the com.example namespace when publishing your applications.

Caution: Once you publish your application, you cannot change the package name. The package name
defines your application's identity, so if you change it, then it is considered to be a different application
and users of the previous version cannot update to the new version.

It is not necessary to change the package name, and most users will never see the package name. However if you want to change your package name to follow package naming conventions or change it for a customer you can.

You also must avoid reserved Java keywords when creating your package name. You can find a list of these in the [Java Language Keywords] topic. If your package name includes any of these, it will fail during the build process.

If you leave this field blank Andromo will use a default package name in this format:

com.andromo.devXXXX.appYYYY

Where XXXX is your User ID, and YYYY is the Project ID.

Note: If you change your package name while you have a Professional subscription and then let your Professional subscription expire, you will not be able to update your app in Google Play, as the package name will revert to the default. Change this value with care.

Show Customized Text on About Dialog
Only available with a Professional subscription.

Allows you to show custom text that will appear on the About dialog, which is accessible from the overflow menu on the toolbar (in the top right corner of the screen).

Enabling this option displays the About Dialog Text field where you can enter the custom dialog text.

About Dialog Text
The text you want to show on the About dialog. This can be useful for showing simple instructions, listing credits for the content you've used, or describing the changes in the latest version of your app.

This text supports some very basic HTML markup: <b> for bold, <i> for italic, and <a> for hyperlinks. (No other HTML is supported.)

Note: the user will be able to scroll the text if you enter more text than will fit on the About dialog at once.