Twitter Activity

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.

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 and on the Action bar. 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"

Description

A few words describing this activity. This text may be displayed on the dashboard as a subtitle when it's Show Subtitle Text setting is enabled.

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 in the action bar drop down. For more information on this setting please read: How to change the order of the icons on the dashboard

Icon

This is where you can select the icon that will be used to represent this activity on the dashboard. Click the 'Browse' button to select and image file.

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.

twitter_activity_search_andromo_framed.png

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.

twitter_activity_click_framed.png

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

twitter_activity_long_click_framed.png

Some Examples

Let’s look at the twitter settings for a twitter list.

First I need to set the Twitter Mode to Tweets from a Twitter List. Next I’ll set the Twitter Username to @verge and the Twitter List to verge. Then after I build you can see the public tweets from the list:

twitter_activity_list_verge_framed.png

Here's an example of searching for #homebrew one of my hobbies:

twitter_activity_homebrew_framed.png

Our last example is the timeline for your favourite twitter user and mine: @AndromoRocks:

twitter_activity_andromorocks_framed.png