Photo Gallery Activity

Photo Gallery Activities allow you to include photos in your app.

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.