As many other social media, Twitpic also provides RESTful API to enable developers to post image to Twitpic. The current version at the time of this writing is version 2 (V2). Using this API, we can build an Android application that features an image upload to Twitpic so we don’t have to create a new infrastructure for image hosting server.

In this tutorial i’ll explain how to send image to Twitpic from an Android application using Twitter4j library. The source code for this tutorial can be downloaded from my github page (see the download link at the bottom of this post).

I. Register Application

To enable an Android application to send image to Twitpic, first you have to register your application to get an API Key. To get an API Key:

• Go to Twitpic developer page and click the Register link. If you’re not logged in before, you have to sign in to Twitpic using your Twitter account.
  
• Register your application.
  
• Save the API Key.
  

II. Android Integration

In my sample project i use Twitter4j library to send image to Twitpic. You can download the latest version from Twitter4j download page or use the library package  i’ve provided in this tutorial. To enable Android to send image to Twitpic, first you have to connect to Twitter first using a Twitter account. How to connect to Twitter will not be explained here, you can read my previous tutorial on how to post Twitter status from Android. So basically to be enable to send image to Twitpic, first you have to sign in to Twitter, get the access token and use the access token along with Twitter consumer key, secret key and Twitpic API key.

In my sample project, i create two packages. The first is for Twitter library, which can be found also on my previous Twitter tutorial sample project and the second is the main application page.

Connect to Twitter (ConnectActivity.java)

This activity displays the Twitter login page and  authenticates user to get the access token. More comprehensive explanation can be found on my previous tutorial.

Send Image to Twitpic (SendImageActivity.java)

In this activity, using an image picker, the image to be sent can be from existing images on sdcard or directly taking a picture from camera. You can read my previous tutorial on how to create image picker on Android to get more deep understanding on how it works. The classes from Twitter4j that are used to send image to Twitpic are:

import twitter4j.conf.Configuration;
import twitter4j.conf.ConfigurationBuilder;
import twitter4j.http.AccessToken;
import twitter4j.http.OAuthAuthorization;
import twitter4j.util.ImageUpload;

 private class ImageSender extends AsyncTask<URL, Integer, Long> {
    	private String url;

    	protected void onPreExecute() {
			mProgressDialog = ProgressDialog.show(SendImageActivity.this, "", "Sending image...", true);

			mProgressDialog.setCancelable(false);
			mProgressDialog.show();
		}

        protected Long doInBackground(URL... urls) {
            long result = 0;

            TwitterSession twitterSession	= new TwitterSession(SendImageActivity.this);
            AccessToken accessToken 		= twitterSession.getAccessToken();

			Configuration conf = new ConfigurationBuilder()
            .setOAuthConsumerKey(twitter_consumer_key)
            .setOAuthConsumerSecret(twitter_secret_key)
            .setOAuthAccessToken(accessToken.getToken())
            .setOAuthAccessTokenSecret(accessToken.getTokenSecret())
            .build();

			OAuthAuthorization auth = new OAuthAuthorization (conf, conf.getOAuthConsumerKey (), conf.getOAuthConsumerSecret (),
	                new AccessToken (conf.getOAuthAccessToken (), conf.getOAuthAccessTokenSecret ()));

	        ImageUpload upload = ImageUpload.getTwitpicUploader (twitpic_api_key, auth);

	        Log.d(TAG, "Start sending image...");

	        try {
	        	url = upload.upload(new File(mPath));
	        	result = 1;

	        	Log.d(TAG, "Image uploaded, Twitpic url is " + url);
	        } catch (Exception e) {
	        	Log.e(TAG, "Failed to send image");

	        	e.printStackTrace();
	        }

            return result;
        }

        protected void onProgressUpdate(Integer... progress) {
        }

        protected void onPostExecute(Long result) {
        	mProgressDialog.cancel();

        	String text = (result == 1) ? "Image sent successfully.\n Twitpic url is: " + url : "Failed to send image";

        	Toast.makeText(getApplicationContext(), text, Toast.LENGTH_LONG).show();
        }
    }

In this example, i use asynchronous task to send image to Twitpic, you can use more convenience way to send the image such as using background service with queue to manage uploading multiple images. The main code for sending image to Twitpic defined in doInBackground() method.

line 14: create an object of TwitterSession class to get the accsess token that was previously saved when user was successfully authenticated.

line 15: get the access token object.

line 16: create the configuration object with Twitter consumer key, secret key, access token and access token secret as parameters.

line 24: create the authorization object.

line 27: create the Twitpic image uploader object.

line 32: upload the image file to Twitpic, the method uses file path to the image that was selected from image picker.

lin3 35: if success, the upload method will return the Twitpic url to the uploaded image, ex: http://twitpic.com/6hqd44

Download

• Download source code from my github page
• Download Twitter external jars (Twitter4j and signpost)

I’ve created a sample project to show how to select and crop image from files or from camera. The source files can be downloaded from my github repository (see the bottom if this post).

MainActivity.java

 final String [] items	      = new String [] {"Take from camera", "Select from Gallery"};
 ArrayAdapter<String> adapter = new ArrayAdapter<String> (this, android.R.layout.select_dialog_item,items);
 AlertDialog.Builder builder  = new AlertDialog.Builder(this);

 builder.setTitle("Select Image");
 builder.setAdapter( adapter, new DialogInterface.OnClickListener() {
    public void onClick( DialogInterface dialog, int item ) { //pick from camer
	if (item == 0) {
	    Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);

	    mImageCaptureUri = Uri.fromFile(new File(Environment.getExternalStorageDirectory(),
				 "tmp_avatar_" + String.valueOf(System.currentTimeMillis()) + ".jpg"));

	    intent.putExtra(android.provider.MediaStore.EXTRA_OUTPUT, mImageCaptureUri);

	    try {
		intent.putExtra("return-data", true);

		startActivityForResult(intent, PICK_FROM_CAMERA);
	    } catch (ActivityNotFoundException e) {
		e.printStackTrace();
	    }
       } else { //pick from file
	   Intent intent = new Intent();

	   intent.setType("image/*");
	   intent.setAction(Intent.ACTION_GET_CONTENT);

	   startActivityForResult(Intent.createChooser(intent, "Complete action using"), PICK_FROM_FILE);
       }
    }
 } );

final AlertDialog dialog = builder.create();

Button button 	= (Button) findViewById(R.id.btn_crop);
mImageView	= (ImageView) findViewById(R.id.iv_photo);

button.setOnClickListener(new View.OnClickListener() {
   @Override
   public void onClick(View v) {
	dialog.show();
   }
});

Line 1: In this example, i use a selector dialog to display two image source options, from camera ‘Take from camera’ and from existing files ‘Select from gallery’

Line 9: To take a photo from camera, pass intent action ‘MediaStore.ACTION_IMAGE_CAPTURE‘ to open the camera app.
Line 11: Also specify the Uri to save the image on specified path and file name. Note that this Uri variable also used by gallery app to hold the selected image path.
Line 24-29: To select an image from existing files, use Intent.createChooser to open image chooser. Android will automatically display a list of supported applications, such as image gallery or file manager.

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
   if (resultCode != RESULT_OK) return;
       switch (requestCode) {
          case PICK_FROM_CAMERA:
	     doCrop();
             break;

          case PICK_FROM_FILE:
	     mImageCaptureUri = data.getData();

             doCrop();

             break;

Line 10: After taking a picture, do the crop
Line 6: After selecting image from files, save the selected path

private void doCrop() {
		final ArrayList<CropOption> cropOptions = new ArrayList<CropOption>();

    	Intent intent = new Intent("com.android.camera.action.CROP");
        intent.setType("image/*");

        List<ResolveInfo> list = getPackageManager().queryIntentActivities( intent, 0 );

        int size = list.size();

        if (size == 0) {
        	Toast.makeText(this, "Can not find image crop app", Toast.LENGTH_SHORT).show();

            return;
        } else {
        	intent.setData(mImageCaptureUri);

            intent.putExtra("outputX", 200);
            intent.putExtra("outputY", 200);
            intent.putExtra("aspectX", 1);
            intent.putExtra("aspectY", 1);
            intent.putExtra("scale", true);
            intent.putExtra("return-data", true);

        	if (size == 1) {
        		Intent i 		= new Intent(intent);
	        	ResolveInfo res	= list.get(0);

	        	i.setComponent( new ComponentName(res.activityInfo.packageName, res.activityInfo.name));

	        	startActivityForResult(i, CROP_FROM_CAMERA);
        	} else {
		        for (ResolveInfo res : list) {
		        	final CropOption co = new CropOption();

		        	co.title 	= getPackageManager().getApplicationLabel(res.activityInfo.applicationInfo);
		        	co.icon		= getPackageManager().getApplicationIcon(res.activityInfo.applicationInfo);
		        	co.appIntent= new Intent(intent);

		        	co.appIntent.setComponent( new ComponentName(res.activityInfo.packageName, res.activityInfo.name));

		            cropOptions.add(co);
		        }

		        CropOptionAdapter adapter = new CropOptionAdapter(getApplicationContext(), cropOptions);

		        AlertDialog.Builder builder = new AlertDialog.Builder(this);
		        builder.setTitle("Choose Crop App");
		        builder.setAdapter( adapter, new DialogInterface.OnClickListener() {
		            public void onClick( DialogInterface dialog, int item ) {
		                startActivityForResult( cropOptions.get(item).appIntent, CROP_FROM_CAMERA);
		            }
		        });

		        builder.setOnCancelListener( new DialogInterface.OnCancelListener() {
		            @Override
		            public void onCancel( DialogInterface dialog ) {

		                if (mImageCaptureUri != null ) {
		                    getContentResolver().delete(mImageCaptureUri, null, null );
		                    mImageCaptureUri = null;
		                }
		            }
		        } );

		        AlertDialog alert = builder.create();

		        alert.show();
        	}
        }
	}

Line 4: Open image crop app by starting an intent ‘com.android.camera.action.CROP‘.
Line 7: Check if there is image cropper app installed.
Line 11: If there is no image cropper app, display warning message
Line 16-23: Specify the image path, crop dimension and scale
Line 25: There is posibility when more than one image cropper app exist, so we have to check for it first. If there is only one app, open then app.
Line 33-68. If there are several app exist, create a custom chooser to let user selects the app.

@Override
	protected void onActivityResult(int requestCode, int resultCode, Intent data) {
	    if (resultCode != RESULT_OK) return;

	    switch (requestCode) {

		    case CROP_FROM_CAMERA:
		        Bundle extras = data.getExtras();

		        if (extras != null) {
		            Bitmap photo = extras.getParcelable("data");

		            mImageView.setImageBitmap(photo);
		        }

		        File f = new File(mImageCaptureUri.getPath());

		        if (f.exists()) f.delete();

		        break;

Line 11: After cropping the image, get the bitmap of the cropped image and display it on imageview.
Line 16: Delete the temporary image

Download source code (github)

I. Register application

To register your application:

• Go to Foursquare Oauth page and login with your username and password
• After logged in, click the ‘REGISTER A NEW CONSUMER’ button



• Fill the registration form with your application name, application website url and the callback url. For callback url, you can use any url or string if your app is for mobile application only, for example myapp://connect

<

• After finishing the registration , you’ll get client id and client secret key that will be used later to connect to Foursquare from Android app.

I’ve included a sample project in this tutorial that can be downloaded on my github repo here. I’ll explain how to use my implementation based on the sample project. In my sample project, i create three classes used to handle authentication and connection to Foursquare: FoursquareApp.java (handle oauth authentification), FoursquareSession.java (save access token on shared preferences) and FoursquareDialog.java (webview authentication dialog).

Main.java

public class Main extends Activity {
	private FoursquareApp mFsqApp;
	private ListView mListView;
	private NearbyAdapter mAdapter;
	private ArrayList<FsqVenue> mNearbyList;
	private ProgressDialog mProgress;

	public static final String CLIENT_ID = "your client id";
	public static final String CLIENT_SECRET = "your client secret";

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setContentView(R.layout.main);

        final TextView nameTv 		= (TextView) findViewById(R.id.tv_name);
        Button connectBtn 			= (Button) findViewById(R.id.b_connect);
        final EditText latitudeEt	= (EditText) findViewById(R.id.et_latitude);
        final EditText longitudeEt	= (EditText) findViewById(R.id.et_longitude);
        Button goBtn				= (Button) findViewById(R.id.b_go);
        mListView					= (ListView) findViewById(R.id.lv_places);

        mFsqApp 		= new FoursquareApp(this, CLIENT_ID, CLIENT_SECRET);

        mAdapter 		= new NearbyAdapter(this);
        mNearbyList		= new ArrayList<FsqVenue>();
        mProgress		= new ProgressDialog(this);

        mProgress.setMessage("Loading data ...");

        if (mFsqApp.hasAccessToken()) nameTv.setText("Connected as " + mFsqApp.getUserName());

        FsqAuthListener listener = new FsqAuthListener() {
        	@Override
        	public void onSuccess() {
        		Toast.makeText(Main.this, "Connected as " + mFsqApp.getUserName(), Toast.LENGTH_SHORT).show();
        		nameTv.setText("Connected as " + mFsqApp.getUserName());
        	}

        	@Override
        	public void onFail(String error) {
        		Toast.makeText(Main.this, error, Toast.LENGTH_SHORT).show();
        	}
        };

        mFsqApp.setListener(listener);

        //get access token and user name from foursquare
        connectBtn.setOnClickListener(new OnClickListener() {
        	@Override
        	public void onClick(View v) {
        		mFsqApp.authorize();
        	}
        });

        //use access token to get nearby places
        goBtn.setOnClickListener(new OnClickListener() {
        	@Override
        	public void onClick(View v) {
        		String latitude  = latitudeEt.getText().toString();
        		String longitude = longitudeEt.getText().toString();

        		if (latitude.equals("") || longitude.equals("")) {
        			Toast.makeText(Main.this, "Latitude or longitude is empty", Toast.LENGTH_SHORT).show();
        			return;
        		}

    			double lat	= Double.valueOf(latitude);
    			double lon	= Double.valueOf(longitude);

        		loadNearbyPlaces(lat, lon);
        	}
        });
    }

    private void loadNearbyPlaces(final double latitude, final double longitude) {
    	mProgress.show();

    	new Thread() {
    		@Override
    		public void run() {
    			int what = 0;

    			try {

    				mNearbyList = mFsqApp.getNearby(latitude, longitude);
    			} catch (Exception e) {
    				what = 1;
    				e.printStackTrace();
    			}

    			mHandler.sendMessage(mHandler.obtainMessage(what));
    		}
    	}.start();
    }

    private Handler mHandler = new Handler() {
    	@Override
    	public void handleMessage(Message msg) {
    		mProgress.dismiss();

    		if (msg.what == 0) {
    			if (mNearbyList.size() == 0) {
    				Toast.makeText(Main.this, "No nearby places available", Toast.LENGTH_SHORT).show();
    				return;
    			}

    			mAdapter.setData(mNearbyList);
    			mListView.setAdapter(mAdapter);
    		} else {
    			Toast.makeText(Main.this, "Failed to load nearby places", Toast.LENGTH_SHORT).show();
    		}
    	}
    };
}

The example above shows how to authenticate user to get access token, display the webview authentication dialog then use the access token to access Foursquare API endpoint which in this example is to get the nearby venues.

Line 8-9: First, replace the CLIENT_ID and CLIENT_SECREET with your app client id and client secret
Line 24: Create an instance of FoursquareApp class and pass the CLIENT_ID and CLIENT_SECRET as parameters
Line 32: Check if user has access token (already authorized the app before) using hasAccessToken
method.
Line 34: Setup listener to handle authorization result event (success or fail)
Line 53: Display the authentication dialog
Line 87: Get nearby venues, an example how to access Foursquare API endpoint. The getNearbyVenue method was defined in FourquareApp.java

FoursquareApp.java

public static final String CALLBACK_URL = "myapp://connect";
private static final String AUTH_URL = "https://foursquare.com/oauth2/authenticate?response_type=code";
private static final String TOKEN_URL = "https://foursquare.com/oauth2/access_token?grant_type=authorization_code";
private static final String API_URL = "https://api.foursquare.com/v2";

Line 1: Replace the CALLBACK_URL with your callback url set before on web settings.
Line 4: API_URL is the root url for Foursquare API endpoint. Do not change this url unless Foursqure make changes on their API url.

public ArrayList<FsqVenue> getNearby(double latitude, double longitude) throws Exception {
		ArrayList<FsqVenue> venueList = new ArrayList<FsqVenue>();

		try {
			String ll 	= String.valueOf(latitude) + "," + String.valueOf(longitude);
			URL url 	= new URL(API_URL + "/venues/search?ll=" + ll + "&oauth_token=" + mAccessToken);

			Log.d(TAG, "Opening URL " + url.toString());

			HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection();

			urlConnection.setRequestMethod("GET");
			urlConnection.setDoInput(true);
			urlConnection.setDoOutput(true);

			urlConnection.connect();

			String response		= streamToString(urlConnection.getInputStream());
			JSONObject jsonObj 	= (JSONObject) new JSONTokener(response).nextValue();

			JSONArray groups	= (JSONArray) jsonObj.getJSONObject("response").getJSONArray("groups");

			int length			= groups.length();

			if (length > 0) {
				for (int i = 0; i < length; i++) {
					JSONObject group 	= (JSONObject) groups.get(i);
					JSONArray items 	= (JSONArray) group.getJSONArray("items");

					int ilength 		= items.length();

					for (int j = 0; j < ilength; j++) {
						JSONObject item = (JSONObject) items.get(j);

						FsqVenue venue 	= new FsqVenue();

						venue.id 		= item.getString("id");
						venue.name		= item.getString("name");

						JSONObject location = (JSONObject) item.getJSONObject("location");

						Location loc 	= new Location(LocationManager.GPS_PROVIDER);

						loc.setLatitude(Double.valueOf(location.getString("lat")));
						loc.setLongitude(Double.valueOf(location.getString("lng")));

						venue.location	= loc;
						venue.address	= location.getString("address");
						venue.distance	= location.getInt("distance");
						venue.herenow	= item.getJSONObject("hereNow").getInt("count");
						venue.type		= group.getString("type");

						venueList.add(venue);
					}
				}
			}
		} catch (Exception ex) {
			throw ex;
		}

		return venueList;
	}

To access Foursquare API endpoint, use standard HTTPURLConnection class, where the url depends on what endpoint you want to access. Complete list of Foursquare API endpoints can be found here.

I. Register Twitter Application

To enable user to post status to Twitter, first you have to create one Twitter application. Simply go to Twitter Apps page and register your application. Fill the ‘Application Name‘ with your desired name, it has to be unique. If you use a name that already exist (taken by someone), you’ll get a warning message.  On ‘Application Type’ option, choose ‘Browser’ , and because its a browser type application but used in mobile application, you can set it’s callback url on ‘Callback URL‘ field  with any url you want. On ‘Default Access type’, choose ‘Read and Write‘ to enable access to post status. Click save and if all things going well, you’ll get a page showing your consumer key and secret key. Copy these two keys for later use in Android app.

II. Android Integration

To integrate Twitter into Android app, you need four external jar files from two different libraries, Twitter4j and oauth-signpost. You can download latest version from Twitter4j download page or use the one included in my sample project (twitter4j-core-2.1.6.jar) and oauth-signpost from oauth-signpost download page (signpost-core-1.2.1.1.jar, signpost-commonshttp4-1.2.1.1.jar, signpost-jetty6-1.2.1.1.jar). Add the four external jars into your Android project (on Eclipse, right click on your project->properties then on Java Build Path click Add External JARs button to select files)

In my sample project, i create three helper classes (TwitterApp.java,  TwitterDialog.java, and TwitterSession.java) to handle authentication using Webview Dialog and session handler to save token and username on Shared Preferences.

Code implementation

1. Twitter Connection (TestConnection.java)

This example shows how to connect to Twitter, display webview dialog to authorize user then save user’s token and username on shared preference for later use.

public class TestConnect extends Activity {
	private TwitterApp mTwitter;
	private CheckBox mTwitterBtn;

	private static final String twitter_consumer_key = "xxx";
	private static final String twitter_secret_key = "xxx";

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);

		setContentView(R.layout.main);

		mTwitterBtn	= (CheckBox) findViewById(R.id.twitterCheck);

		mTwitterBtn.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				onTwitterClick();
			}
		});

		mTwitter 	= new TwitterApp(this, twitter_consumer_key,twitter_secret_key);

		mTwitter.setListener(mTwLoginDialogListener);

		if (mTwitter.hasAccessToken()) {
			mTwitterBtn.setChecked(true);

			String username = mTwitter.getUsername();
			username		= (username.equals("")) ? "Unknown" : username;

			mTwitterBtn.setText("  Twitter (" + username + ")");
			mTwitterBtn.setTextColor(Color.WHITE);
		}

		Button goBtn = (Button) findViewById(R.id.button1);

		goBtn.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				startActivity(new Intent(TestConnect.this, TestPost.class));
			}
		});
	}

	private void onTwitterClick() {
		if (mTwitter.hasAccessToken()) {
			final AlertDialog.Builder builder = new AlertDialog.Builder(this);

			builder.setMessage("Delete current Twitter connection?")
			       .setCancelable(false)
			       .setPositiveButton("Yes", new DialogInterface.OnClickListener() {
			           public void onClick(DialogInterface dialog, int id) {
			        	   mTwitter.resetAccessToken();

			        	   mTwitterBtn.setChecked(false);
			        	   mTwitterBtn.setText("  Twitter (Not connected)");
			        	   mTwitterBtn.setTextColor(Color.GRAY);
			           }
			       })
			       .setNegativeButton("No", new DialogInterface.OnClickListener() {
			           public void onClick(DialogInterface dialog, int id) {
			                dialog.cancel();

			                mTwitterBtn.setChecked(true);
			           }
			       });
			final AlertDialog alert = builder.create();

			alert.show();
		} else {
			mTwitterBtn.setChecked(false);

			mTwitter.authorize();
		}
	}

	private final TwDialogListener mTwLoginDialogListener = new TwDialogListener() {
		@Override
		public void onComplete(String value) {
			String username = mTwitter.getUsername();
			username		= (username.equals("")) ? "No Name" : username;

			mTwitterBtn.setText("  Twitter  (" + username + ")");
			mTwitterBtn.setChecked(true);
			mTwitterBtn.setTextColor(Color.WHITE);

			Toast.makeText(TestConnect.this, "Connected to Twitter as " + username, Toast.LENGTH_LONG).show();
		}

		@Override
		public void onError(String value) {
			mTwitterBtn.setChecked(false);

			Toast.makeText(TestConnect.this, "Twitter connection failed", Toast.LENGTH_LONG).show();
		}
	};
}

First, create an instance of  TwiterApp class with context, consumer key and secret key as constructor’s parameters. Use hasAccessToken() method to check if there is previously saved session. If there is no saved session, call authorize() to open authorization dialog. If user allows the connection, his access token and user name will be saved on shared preferences. You can setup listener to handle on success and on error event by creating an instance of TwDialogListener and pass it to setListener() method.

2. Post Status (TestPost.java)

This example shows how to post Twitter status. If there is no previously saved session, display authorization dialog to allow user authorize the connection then post status using different thread.

public class TestPost extends Activity {
	private TwitterApp mTwitter;
	private CheckBox mTwitterBtn;
	private String username = "";
	private boolean postToTwitter = false;

	private static final String twitter_consumer_key = "xxxx";
	private static final String twitter_secret_key = "xxxx";

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);

		setContentView(R.layout.post);

		Button postBtn 				= (Button) findViewById(R.id.button1);
		final EditText reviewEdit   = (EditText) findViewById(R.id.revieew);

		postBtn.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				String review = reviewEdit.getText().toString();

				if (review.equals("")) return;

				postReview(review);

				if (postToTwitter) postToTwitter(review);
			}
		});

		mTwitter = new TwitterApp(this, twitter_consumer_key,twitter_secret_key);

		mTwitter.setListener(mTwLoginDialogListener);

		mTwitterBtn	= (CheckBox) findViewById(R.id.twitterCheck);

		mTwitterBtn.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				if (mTwitter.hasAccessToken()) {
					postToTwitter = mTwitterBtn.isChecked();
				} else {
					mTwitterBtn.setChecked(false);
					mTwitter.authorize();
				}
			}
		});

		if (mTwitter.hasAccessToken()) {
			username 	= mTwitter.getUsername();
			username	= (username.equals("")) ? "No Name" : username;

			mTwitterBtn.setText("  Twitter  (" + username + ")");
		}
	}

	private void postReview(String review) {
		//post to server

		Toast.makeText(this, "Review posted", Toast.LENGTH_SHORT).show();
	}

	private void postToTwitter(final String review) {
		new Thread() {
			@Override
			public void run() {
				int what = 0;

				try {
					mTwitter.updateStatus(review);
				} catch (Exception e) {
					what = 1;
				}

				mHandler.sendMessage(mHandler.obtainMessage(what));
			}
		}.start();
	}

	private Handler mHandler = new Handler() {
		@Override
		public void handleMessage(Message msg) {
			String text = (msg.what == 0) ? "Posted to Twitter" : "Post to Twitter failed";

			Toast.makeText(TestPost.this, text, Toast.LENGTH_SHORT).show();
		}
	};
	private final TwDialogListener mTwLoginDialogListener = new TwDialogListener() {
		@Override
		public void onComplete(String value) {
			username 	= mTwitter.getUsername();
			username	= (username.equals("")) ? "No Name" : username;

			mTwitterBtn.setText("  Twitter  (" + username + ")");
			mTwitterBtn.setChecked(true);

			postToTwitter = true;

			Toast.makeText(TestPost.this, "Connected to Twitter as " + username, Toast.LENGTH_LONG).show();
		}

		@Override
		public void onError(String value) {
			mTwitterBtn.setChecked(false);

			Toast.makeText(TestPost.this, "Twitter connection failed", Toast.LENGTH_LONG).show();
		}
	};
}

Update 2011-10-01

- Fix authorization failed bug when attempt to authorize after logging out. This was caused by an exception (java.lang.IllegalStateException: consumer key/secret pair already set) was thrown by setOauthConsumer(consumerKey,secretKey) method of Twitter class. This method should be called once.

You can download  the source code here (with external jars) or via github here

I have updated the quickaction implementation code so it can be used more efficient and the dialog will be automatically dismissed after pressing the action item. All the source codes now available via github so you can track the changes.

Official Twitter application for Android  has introduced new Android UI features and behavior patterns such as Dashboard, Search Bar, QuickAction and Action Bar. One of the interesting pattern is QuickActions that displays contextual actions in a list view. This pattern actually already exists in QuickContact dialog/bar in default Contact application (since Android 2.0).

The QuickActions dialog is not included in standard Android SDK, so we have to create it manually. At first, i had no idea on how to create it so i decided to download and read the Contact app source code from  Android git. I found that the QuickContact dialog  uses private API call (com.android.internal.policy.PolicyManager) that does not exists in standard SDK. After posting question about it on google groups and stack overflow, i got the solution for it from Qberticus (thanx Qberticus!).

Qberticus’s QuickActions uses simple/plain layout so i have to create a custom layout so it will look like QuickContact in Contact app or QuickActions in Twitter app. Based on QuickContact source code, i made a slight modification on Qberticus’s BetterPopupWindow class and extended it to implement custom layout. I also made it customizeable, so the icon and text in action list can be customized.

Here are the screenshoots of QuickActions demo:

QuickContact / Twitter-like QuickActions

Code snippet
Create action items

//Add action item
ActionItem addAction = new ActionItem();

addAction.setTitle("Add");
addAction.setIcon(getResources().getDrawable(R.drawable.ic_add));

//Accept action item
ActionItem accAction = new ActionItem();

accAction.setTitle("Accept");
accAction.setIcon(getResources().getDrawable(R.drawable.ic_accept));

//Upload action item
ActionItem upAction = new ActionItem();

upAction.setTitle("Upload");
upAction.setIcon(getResources().getDrawable(R.drawable.ic_up));

Line 02: Create new action item
Line 04: Set action title
Line 05: Set action icon

Create quickaction instance and setup listener

final QuickAction mQuickAction 	= new QuickAction(this);

mQuickAction.addActionItem(addAction);
mQuickAction.addActionItem(accAction);
mQuickAction.addActionItem(upAction);

//setup the action item click listener
mQuickAction.setOnActionItemClickListener(new QuickAction.OnActionItemClickListener() {
	@Override
        public void onItemClick(int pos) {
		if (pos == 0) { //Add item selected
		   Toast.makeText(Example1Activity.this, "Add item selected", Toast.LENGTH_SHORT).show();
		} else if (pos == 1) { //Accept item selected
		   Toast.makeText(Example1Activity.this, "Accept item selected", Toast.LENGTH_SHORT).show();
		} else if (pos == 2) { //Upload item selected
		   Toast.makeText(Example1Activity.this, "Upload items selected", Toast.LENGTH_SHORT).show();
		}
	}
});

Line 1: Create quickaction instance
Line 3-5: Add the action items into quikaction
Line 8: Setup listener for action item clicked, the pos argument on onItemClick method shows which action item is clicked.

Show quickAction dialog

btn1.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
	mQuickAction.show(v);
}
});

Line 04: Show quickaction dialog, the v argument used as the anchor where the quickaction displayed.

Gallery3D-like QuickActions

Implementation on My Application

BlitzDroid

Minapolitan (Prototype)

Buy me a coffee

If you found this stuff useful to your work, please consider a donation.
By doing this you will be helping me to keep improving this stuff and to continue to help anyone who needs, and maybe keep on helping you in the future.

Thanks for your support, will do my best to keep the info fresh and useful.

Creating an update zip file is quite easy, all you have to do is put the files in corresponding directory in Android file system and an update-script file to copy the files. For example, to install Calculator.apk into system/app and copy libsec-ril.so file into system/lib :

• Create an empty folder (eg. C:\myupdate)
• Create C:\myupdate\system\app folder for Calculator.apk and  C:\myupdate\system\lib folder for libsec-ril.so
• Create C:\myupdate\META-INF\com\google\android folder for update-script file.
• Create the update-script file with the following syntax:

show_progress 0.1 0

copy_dir PACKAGE:system SYSTEM:

show_progress 0.1 10

Line 1&5 : show progress bar
Line 3: copy system folder from update package to Android’s /system

Note: you should add one extra  line at the end of the file (Line 6)

• Compress the entire contents of C:\myupdate folder to zip (not the myupdate folder itself)
• Sign the myupdate.zip file

java -jar signapk.jar certificate.pem key.pk8 myupdate.zip update.zip

Note: you can find tutorial on how to sign the update.zip file here

• Copy the update.zip file to sdcard and apply it from recovery console

update-script syntax reference (definitions from recovery.c android source code):

• copy_dir

Syntax: copy_dir <src-dir> <dst-dir> [<timestamp>]
Copy the contents of <src-dir> to  <dst-dir>. The original contents of <dst-dir> are preserved unless something in <src-dir> overwrote them.
Ex: copy_dir PACKAGE:system SYSTEM:

• format

Syntax: format <root>
Format a partiti0n
Ex: format SYSTEM:, will format entire /system . Note: formatting erases data irreversibly.

• delete

Syntax: delete <file1> [... <fileN>]
Delete  file.
EX: delete SYSTEM:app/Calculator.apk, will delete Calculator.apk from system/app directory.

• delete_recursive

Syntax: delete_recursive <file-or-dir1> [... <file-or-dirN>]
Delete a file or directory with all of it’s contents recursively
Ex: delete_recursive DATA:dalvik-cache, will delete /data/dalvik-cache directory with all of it’s contents

• run_program

Syntax: run_program <program-file> [<args> ...]
Run an external program included in the update package.
Ex: run_program PACKAGE:install_busybox.sh, will run install_busybox.sh script (shell command) included in the update package.

• set_perm

Syntax: set_perm <uid> <gid> <mode> <path> [... <pathN>]
Set ownership and permission of single file or entire directory trees, like ‘chmod’, ‘chown’, and ‘chgrp’ all in one
Ex: set_perm 0 2000 0550 SYSTEM:etc/init.goldfish.sh

• set_perm_recursive

Syntax: set_perm_recursive <uid> <gid> <dir-mode> <file-moe> <path> [... <pathN>]
Set ownership and permission of a directory with all of it’s contents recursively

Ex: set_perm_recursive 0 0 0755 0644 SYSTEM:app

• show_progress

Syntax: show_progress <fraction> <duration>
Use of the on-screen progress meter for the next operation, automatically advancing the meter over <duration> seconds (or more rapidly if the actual rate of progress can be determined).
Ex: show_progress 0.1 0

• symlink

Syntax: symlink <link-target> <link-path>

Create a symlink (like ‘ln-s’). The <link-path> is in root:path format, but <link-target> is
for the target filesystem (and may be relative)

Definition of roots and partitions (from root.c android source code)

 ROOT:     (Linux block device) /mountpoint/ fs, size
    Description.

  BOOT:     (/dev/mtdblock[?]) / (RAM)  Raw
    Kernel, ramdisk and  boot config.
  DATA:     (/dev/mtdblock5)   /data/   yaffs2, 91904kb
    User, system config,  app config, and apps (without  a2sd)
  CACHE:    (/dev/mtdblock4)   /cache/  yaffs2, 30720kb
    OTA cache,  Recovery/update config and temp
  MISC:     (/dev/mtdblock[?]) N/A     Raw
    [TODO: Get info on MISC:]
  PACKAGE:  (Relative to package file) N/A
    Pseudo-filesystem for update  package.
  RECOVERY: (/dev/mtdblock[?]) / (RAM) Raw,     [?]kb
    The recovery  and update environment's kernel and ramdisk.
    Similar to BOOT:.
  SDCARD:   (/dev/mmcblk0(p1)) /sdcard/ fat32,  32MB-32GB
    The microSD card. Update zip is usually here.
  SYSTEM:   (/dev/mtdblock3)   /system/ yaffs2, 92160kb
    The OS partition,    static and read-only.
  TMP:                         /tmp/    in RAM
    Standard Linux temporary directory.
    Cleared on poweroff/reboot.

SignApk.jar is a tool included with the Android platform source bundle, you can download it from here. To use SignApk.jar you have to create a private key with it’s corresponding certificate/public key. To create private/public key pair, you can use Openssl. Openssl is relatively easy to use under unix/linux system. For Windows user, you can download Windows version of Openssl here.

How to create private/public key pair using openssl (windows version)

• Download openssl package from link given above
• Extract it anywhere on your drive (eg. C:\openssl)
• Within openssl directory type (use cmd tool):

- openssl genrsa -out key.pem 1024
- openssl req -new -key key.pem -out request.pem
- openssl x509 -req -days 9999 -in request.pem -signkey key.pem -out certificate.pem
- openssl pkcs8 -topk8 -outform DER -in key.pem -inform PEM -out key.pk8 -nocrypt

How to sign apk or zip files using SignApk.jar:

• Download SignApk.rar from link given above
• Extract it  anywhere on your drive (eg. c:\SignApk)
• If you don’t have java installed, download and install it.
• Copy certificate.pem and key.pk8 into your extracted SignApk directory
• Within SignApk directory type:

java -jar signapk.jar certificate.pem key.pk8 your-app.apk  your-signed-app.apk

OR

java -jar signapk.jar certificate.pem key.pk8 your-update.zip your-signed-update.zip

Note:

If you don’t want to create your own public/private key pair, you can use test key included in SignApk.rar.

Reference:

android-dls.com

Another alternative method is by using a software based virtual access point that using Windows 7’s Wireless Hosted Network technology. This method only runs on Windows 7 and hardware specific. Currently i found two best virtual access point softwares, Virtual Router and Connectify. They both operate in the same maner and very easy to use. I have tested both of them to share internet connection from my PC that used  Sierra Wireless USBConnect 881 modem for internet access and an external TP-Link TL-WN31G Wireless USB adapter with my Samsung Spica.

Here is the guide on how to use virtual router and connectify

On Windows 7 Box:

• Download and install Virtual Router or Connectify, you can try one of them. They are hardware specific so read the documentation on their websites about the supported WiFi devices.
• Fill in the settings panel with your prefered WiFi name, password and internet connection to share


Virtual Router



Connectify

• Click start button to start sharing
• On your Wireless Connection Status, click Details to get the network connection information, note the IPV4 Address

On Android Device

• Go to Settings -> Wireless & networks -> Wi-Fi Settings
• Open Advance settings menu
• Tick the Use static IP option
• Enter your desired IP address (ex: 192.168.2.2)  into Ip Address field
  
• Enter your IPV4 Address (ex. 192.168.2.1) into Gateway field
• Enter 255.255.255.0 into Netmask field
• Enter your internet connection’s DNS server (use ipconfig /all command to get DNS info) into DNS 1 and DNS 2. As an alternative, you can use Google Public DNS: 8.8.8.8 and 8.8.4.4


Wifi Static IP Setting

• Connect to Wi-Fi using your password
• Disable and Enable Wi-Fi (in case if it won’t connect)


Android Wi-Fi

• Check the connection using browser or other application.

Update:

Latest version of Connectify uses dhcp so it is unnecessary to use static ip on Android.

If you have trouble while using Virtual Router or Connectify, please check if your wifi card is supported or read the documentation or disccussion on their support page.

Supported devices: Virtual Router | Connectify

Documentation and support: Virtual Router | Connectify

Troubleshooting:

If you can’t connect to internet though the client already connected to the hotspot (connectify or virt.router), these are the possible solutions:

• Try to disable antivirus or firewall
• Try to stop and start the hotspot
• Try to kill the hotspot process using task manager and restart the hotspot
• Try to disable and enable wifi on Android
• Check if your wifi card supported by the hotspot (check the reference sites above)

You can use this guide to upgrade your Spica at your own risk and don’t blame me if you turn out your Spica into a bricked device .

(This guide has been updated on 07 May 2010, find it at the bottom of this post)

MULTITOUCH now is enabled on Spica, check the guide on how to enable it here

What you need:

• Firmware I570EXXJCE (I570EXXJCE.zip )
• Odin Multi Downloader + spica_jc3.ops (Odin_v4.03_spica_jc3_ops.rar)
• Boot loader file (jb4_bootloader.rar)
• CSC file (I570EOLBJB3-CSC-CL167487-OLB.tar)
• For Windows XP users: Samsung USB driver for I5700 (available in your Samsung New PC Studio CD)
• For Windows 7 users: drivers from PC Studio CD will not work. Download & install the latest Samsung Kies
• Samsung USB cable

Alternative download links (Mydropbox, ads free, direct download) (Big thanx to Yousef):

• I570EXXJCE.zip
• Odin_v4.03_spica_jc3_ops.rar
• jb4_bootloader.rar
• I570EOLBJB3-CSC-CL167487-OLB.tar

Note for I5700 driver:

If windows doesn’t detect the phone in download mode, disconnect the phone & try to uninstall pc studio or kies then reboot. Reinstall pc studio or kies then connect the phone (you may also remove & insert the battery before connecting the phone).

Before start checklist:

• Check your firmware using *#1234#
• Backup your data (contacts, sms, etc)
• Ensure that your phone battery power is sufficient
• Release the SIM lock (check SIM lock status using *#7465625#)
• Extract all required files into a folder (those files will be: I570EXXJCE.zip –> I570EXXJCE.tar; Odin_v4.03_spica_jc3_ops.rar –> Odin Multi Downloader v4.03.exe, spica_jc3.ops; jb4_bootloader.rar –> I570EXXJA1_CLI32638_Bootloader.tar, I570XXJB4_Phone.tar; I570EOLBJB3-CSC-CL167487-OLB.tar).
• Shutdown or disable  Antivirus and Samsung PC Studio if any.

How to flash:

Preparation

1. Shutdown your phone and remove the SIM Card and SDCard.
2. Press “volume down + power button + camera“ to put the phone into download mode.


Spica Download Mode

3. Connect the phone to PC using USB cable. You can check the connection in Windows device manager, make sure that your phone is properly detected by Windows like picture below


Windows Device Manager

4. Run the Odin Multi Download v4.03.exe. If your phone is properly detected, the Com Port Mapping field should be in yellow background.

Flash I

1. Select spica_jc3.ops into Select OPS field
2. Select I570EXXJCE.tar into Selet Integrate Package – Choose One Package Option field
3. Tick the One Package option
4. Click Start to start flashing. The timer and progress bar above COM Port Mapping field should start . If the progress bar doesn’t start but the timer continue to run , close Odin and disconnect the phone from PC. Remove and insert the battery and start the phone in download mode again, then run Odin.
5. Wait until PASS message appear in Message box and the progress bar box turns into blue.
6. At this step, you may get the flashing seems to be failed, and you’ll see exclamation mark appears like image shown below. Don’t worry, this is not the end of your spica, close the Odin and disconnect the phone from PC.



7. Remove and insert the battery, start the phone in download mode then run  Odin again and follow the steps in Flash II.



Click to enlarge

Note: If you already get Eclair on this stage, skip the Flash II & III.

Flash II

1. Keep spica_jc3.ops in Select OPS field.
2. Click Reset Files to clear the fields.
3. In Select Images to download panel, Select I570EXXJA1_CLI32638_Bootloader.tar into BOOT field,I570XXJB4_Phone.tar into PHONE field,  I570EOLBJB3-CSC-CL167487-OLB.tar into CSA field, and let the PDAfield empty.
4. In Debug Option panel, tick  Debug Only and PDA Format option. Don’t tick One Package option in Option Panel.
5. Click Start and watch the progress bar and timer, wait untill PASS message appear on Message box.
6. Disconect the phone from PC, remove and insert the battery, start the phone in download mode again then continue to Flash III.



Click to enlarge

Flash III

1. Keep spica_jc3.ops in Select OPS field.
2. Click Reset Files to clean the fields.
3. In Select Images to download panel, Select I570EXXJCE.tar into PDA field.
4. If you get an error dialog, rename the I570EXXJCE.tar into I570EXXJCE_PDA.tar and insert into PDA field again.
5. Don’t select One Package option and Debug Option.
6. Click Start and watch the progress bar and timer, wait untill PASS message appear on Message box.
7. The phone will restart and you will get the Eclair screen .


Click to enlarge

Now you have the new Eclair in your Spica, but wait, firmare EXXJCE is french firmware, so you’ll get your Spica language in French, to change the language, enter paramètres menu at bottom corner then choose Paramètres de langue then Langue et règion and select your language.

Rooting Your New Eclair

In some cases, you may need your Spica to be rooted in order to install some applications like shootme, my favourite screen capture application. This is just optional, you don’t have to follow this step. I use  LkMod v2.5.1 by Leshak that based on EXXJCE firmware to get my Spica rooted and get some additional features like live wallpaper and custom logo while booting my Spica.

LkMod 2.5.1 features:

• New phone.apk (from xdadev)
• Helixlauncher as default home (can be switched with default Pantheon)
• Live wallpaper
• Root (su)
• Busybox
• Remount
• fdump for backup
• Custom logo

What you need:

• LkMod v.2.5.1 (multiupload) | LkMod v.2.5.1 (mydropbox)
• GNU tar for windows (optional if you wan’t to change the logo)

Create your custom logo (Optional)

Default logo comes with LkMod can be replaced with your own logo, you can replace the logo with your own using Photoshop or other image manipulating software.

How to change the logo:

1. Install the GNU tar for windows, default location is on C:\Program Files\GnuWin32
2. Extract LkMod-2_5_1-PDA.7z and you’ll get  LkMod-2_5_1-PDA.tar
3. Extract LkMod-2_5_1-PDA.tar and you’ll get four files: cache.rfs, datafs.rfs, logo.png and zImage.
4. Create your own logo with 320×480 size and PNG file type. Warning: The size of logo file must be between  30-40 kb or the phone will never be able to boot!!.
5. Save as logo.png and replace the default logo.png
6. Package the four files using GNU tar command line program

>C:\Program Files\GnuWin32\tar -cvf LkMod-2_5_1-PDA.tar cache.rfs datafs.rfs logo.png zImage

7. You’ll get your own LkMod with your own custom logo (LkMod-2_5_1-PDA.tar)

How to flash

1. Select spica_jc3.ops in Select OPS field.
2. Click Reset Files to clean the fields.
3. In Select Images to download panel, Select LkMod-2_5_1-PDA.tar into PDA field.
4. Don’t select One Package option and Debug Option.
5. Click Start and watch the progress bar and timer, wait untill PASS message appear on Message box.
6. The phone will restart and you will get the rooted Eclair with helixlauncher default home.

Usefull information about Samsung Firmware

Europe
XA = Austria, France, Germany, Italy, Netherlands, Switzerland, UK
XB = Denmark, Norway, Sweden
XC = Portugal, Spain
XD = Croatia, Czech, Hungary, Slovakia
XE = Bulgaria, Estonia, Kazakhstan, Latvia, Lithuania, Russia, Ukraine
XF = Bulgaria, Croatia, Romania
XP = Dutch, French, Italian, Spanish, Dutch, Polski, Portuguese, Turkish
XW = UK, Italy, Germany, France, Australia, Netherlands, Belgium, Switzerland
XX = Austria, Belgium, France, Germany, Hungary, Italy, Spain, United Kingdom

Asia
DD = India
DX = Indonesia, Malaysia, Philippines, Singapore, Vietnam
ZC = China, Hong Kong
ZH = Hong Kong

Code = Year – Month
A = 2001 – January
B = 2002 – February
C = 2003 – March
D = 2004 – April
E = 2005 – May
F = 2006 – June
G = 2007 – July
H = 2008 – August
I = 2009 – September
J = 2010 – October
K = 2011 – Novermber
L = 2012 – December

Example,

My Spica has firmware version I5700DXIL1
DX = Indonesia, Malaysia, Philippines, Singapore, Vietnam
I = 2009
L = December
1 = Version

Update May 17, 2010

1. DXJC4 (Asia) Firmware

If you have flashed to JCE and want to reflash it to DXJC4, flash with DXJB3 first (complete package) using Sameer’s guide than flash to DXJC4 as one package.

2. EXXJD1+ Lk2.02 modd

If you are using JCE and want to upgrade to JD1, flash JD1 (complete package) using Sameer’s guide and then apply Leshak’s Lk2.02 mod.

3. F0r Indonesian users that use Europe firmware (jce,jcf,jd1), to overcome problem with 3 and im2 simcard:

- For rooted device without Lk2.02:

• Download libsec-ril.so
• Using ADB tool:
• adb push libsec-ril.so /sdcard
• adb shell
  
• #mount -o remount,rw -t yaffs2 /dev/block/mtdblock3 /system
• #cp /system/lib/libsec-ril.so /sdcard/libsec-ril.so.old (backup)
• #cp /sdcard/libsec-ril.so /system/lib
• #reboot

- For rooted device with Lk2.02 (has recovery tools)

• Download im2-3-update.zip
• Using ADB tool:
• adb push im2-3-update.zip /sdcard
• adb shell
• #reboot recovery
• From recovery menu, choose ‘Apply any zip from SD’
• Select im2-3-update.zip
• Press ‘Home’ for confirm
• Reboot

4. Install Nexus One boot animation (win 7 style)

Nexus one boot animation file (bootanimation.zip) was taken from Leshak’s samdroid mod

- For rooted device without Lk2.02

• Download bootanimation.zip
• Using ADB tool:
• adb push bootanimation.zip /sdcard
• adb shell
• #mount -o remount,rw -t yaffs2 /dev/block/mtdblock3 /system
• #cp /system/media/bootani.qmg /sdcard (backup)
• #cp /system/etc/poweron.snd /sdcard (backup)
• #rm /sytsem/etc/poweron.snd
• #cp /sdcard/bootanimation.zip /system/media
• #reboot

- For rooted device with Lk2.02 (has recover tools)

• Download nexusoneanim_update.zip
• Using ADB tool:
• adb push nexusoneanim_update.zip /sdcard
• adb shell
• #reboot recovery
• From recovery menu, choose ‘Apply any zip from SD’
• Select nexusoneanim_update.zip
• Press ‘home’ for confirm
• Reboot

5. Install Samdroid Mod 1.o.3

Samdroid 1.0.3 can be applied to any 2.1 firmwares + lk2.02 installed and has two partitions on sdcard (one should be ext2 partition).

1. Install Lk2.02 (Ref: samdroid)
   • Download LK2-02-1_update.zip (rapid) | LK2-02-1_update.zip (mydropbox)
   • Copy it to root of sdcard (/sdcard)
   • Download i5700_LK2-02_PDA.tar (rapid) | i5700_LK2-02_PDA.tar (mydropbox)
   • Flash it using odin as PDA file
   • Spica will reboot and enter into recovery mode
   • Select ‘apply any zip from SD’
   • Select LK2-02-1_update.zip then pres’s Home’ to confirm
   • Wait until ‘Install from sd card complete’ appears then reboot
   • Check phone
2. Apply app2sd (Ref: samdroid)
   • Turn off the phone
   • Press ‘Volume down + Call/Answer + Power’ key to enter into recovery mode OR
   • Using adb shell type ‘reboot recovery’
   • Select ‘Partition sd card’
   • Select the size of partition (256, 384 or 512) then press ‘Home’ to confirm
   • Wait until ‘Format SDCARD complete’ appears then reboot
   • Check phone
3. Install samdroid (Ref: samdroid)
   • Download SamdroidMod-1_0_3-update.zip
   • Copy it to root of sdcard (/sdcard)
   • Turn off the phone
   • Press ‘Volume down + Call/Answer + Power’ key to enter into recovery mode OR
   • Using adb shell type ‘reboot recovery’
   • Select ‘wipe, choose what’ -> ‘data/cache’
   • Select ‘Apply any zip from SD’ and choose ‘SamdroidMod-1_0_3-update.zip’
   • Press ‘Home’ to confirm
   • It may take a long time for first time booting (it is normal, you’ll see nexus one boot animation)

Buy me a coffee

If you found this stuff useful to your work, please consider a donation.
By doing this you will be helping me to keep improving this stuff and to continue to help anyone who needs, and maybe keep on helping you in the future.

Android 2.1 on Emulator

This tutorial is intended for new developers that want to start developing Android applications using Eclipse IDE. To start develop, you have to install Java platform (JDK)  first and then  install the Eclipse,  Android SDK and the  Android Development Tool (ADT) plugin for Eclipse.

Download and Install JDK

Download and install the latest JDK (JDK 1.6 Update 18) from JDK download page

Download and Install Eclipse IDE

Download and install Eclipse Classic 3.5 (Galileo) from Eclipse download page. You can also use the  Java or RCP version of Eclipse.

Download and Install Android SDK Starter Package

The Android SDK starter package includes only a single component, the latest version of the SDK Tools. Included in that component is a tool called Android SDK and AVD Manager that you can use to download other components from the SDK repository site.

• Download the latest Android SDK  starter package  from the SDK download page.
• Unpack the archive to a suitable location on your machine. By default, the SDK files are unpacked into a directory named  android-sdk-<machine-platform> . For example, on Windows platform the directory will be android-sdk-windows.


Android SDK

Add Android Platforms to Your SDK

To add one or more Android platforms (for example, Android 1.6 or Android 2.1) to your SDK, use the Android SDK and AVD Manager, included in the SDK starter package. It is recommended  to download multiple platforms, so that you can build your application on the lowest version you want to support, but test against higher versions that you intend the application to run on.

• Launch the Android SDK and AVD Manager on Windows by executing SDK Setup.exe at the root of the SDK directory. On Mac OS X or Linux, execute the android tool in the /tools/ folder.
• On Available Packages menu, select the platforms to download (1.1 to 2.1).



• If you find error on HTTP SSL while fetching the repository url , try to use http instead of https by checking the Force https://… sources to be fetched using http://… option on Settings menu.



• Click Install Selected and then select Accept All to accept selected packages.
• Click Install Accepted button to start download and install the selected packages.

Download and Install ADT Plugin

To install  the ADT Plugin, you can take advantage of the Eclipse remote update feature. By setting up a remote update site, you can easily download, install, and check for ADT updates. Alternatively, you can download the latest ADT to your development computer as a local site archive.

• Launch Eclipse, then select Help –> Install New Software.



• In Available Software dialog, click Add
• Enter a name for the remote site (ex: Android Plugin) in the Name field and in the Location field, enter this URL:
  https://dl-ssl.google.com/android/eclipse/
  and then click OK. If you have trouble acquiring the plugin, you can try using ‘http’  instead of  ’https’  in the URL.



• Select the checkbox next to Developer Tools, which will automatically select the nested tools Android DDMS and Android Development Tools and then click Next.



• On the next dialog, click Next to read and accept the license agreement and install any dependencies, then click Finish.
• Restart Eclipse
• To check whether the ADT has been installed correctly, try to create a new project by select File > New > Project., you shoud find Android Project listed on project wizard.