Here are some notes about dealing with Android/Eclipse that might be helpful. You should expect to have to look some things up, even after carefully reading these notes.

• You might find it useful to use the debugger, adb, from the command line. adb lives in the platform-tools directory of your Android SDK directory.
  • adb shell logs in to the phone and gives you a shell with limited capabilities. I used it to look at what files existed.
  • adb pull filename fetches a file from the phone to your debugging machine.
  • add push localfile phonefile retrieves a file from the phone.
  See the Android debugger page for even more.

• Including a config file in your Android project requires a trick:
  • Put the file in the Assets folder of the Eclipse Android project.
  • Eclipse/Android normally compresses whatever it finds in the Assets folder, but doesn't uncompress it when you try to read the file on the phone. To avoid the compression, give your config file a name with extent 'png', as in jz.cse.config.ini.png.
  • To edit your now .png config file in Eclipse, drag-and-drop it onto the editor pane. (Double-clicking on it causes Eclipse to be smart, and try to treat it as an image file.)

• Similarly, you need to put your photo gallery (folder) somewhere. My code puts it on the SD card. The path to the SD card can be evaluated as Environment.getExternalStorageDirectory().getPath(). (That expression currently evaluates to "/mnt/sdcard".) I know that the Gallery app will notice it if it's there. I don't know if it will notice it if it's somewhere substantially different.

• The Gallery photo viewer seems to index the photo files. The symptom is that when you add a file to your gallery, then bring up the Gallery viewer, you don't see your new photo. To cause the Gallery viewer to reindex (which you should do whenever you change the contents of your gallery directory):

    // Try to update gallery viewer
      sendBroadcast(new Intent(
          Intent.ACTION_MEDIA_MOUNTED,
          Uri.parse("file://" + Environment.getExternalStorageDirectory())));
  

  
  (This assumes your gallery directory is on the SD card.)

• You need permissions in your AndroidManifest.xml file. The full set I used is:

  <uses-permission android:name="android.permission.INTERNET" /> 
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
  <uses-permission android:name="android.permission.CAMERA" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
      
  <uses-feature android:name="android.hardware.camera" />
  

• Make sure you call SNetDB461.registerMember() for both the instance and the root as soon as you've created the SNetDB461 object.

• You invoke other apps (e.g., the camera and gallery viewer apps) using Intents. See this page. You display new screens within your app by calling setContentView() with the layout you want.

• Big images can cause your Android project to run out of memory. To force the camera to give you a not-so-big image, invoke it this way:
  

   Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
   startActivityForResult(intent, CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE);
  

  
  You then retrieve the image the camera captured in your onActivityResult(int requestCode, int resultCode, Intent data) handler, like this:
  

  Bitmap photoBmp = (Bitmap)data.getExtras().get("data");
  

  
  Note: CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE is an integer that you define.

• You can invoke the Gallery app, to allow the user to choose a photo, using this:
  

  Intent intent = new Intent(Intent.ACTION_PICK,
            android.provider.MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
  intent.setType("image/*");
  startActivityForResult(intent, CHOOSE_PICTURE_ACTIVITY_REQUEST_CODE);
  

  
  You then retrieve the path to the photo the user selected (in your onActivityResult() method) using this code. (There may be easier ways than this, but this is what I used.)

  Uri selectedImage = data.getData();
  String[] filePathColumn = {MediaStore.Images.Media.DATA};
  
  Cursor cursor = getContentResolver().query(selectedImage, filePathColumn, null, null, null);
  cursor.moveToFirst();
  
  int columnIndex = cursor.getColumnIndex(filePathColumn[0]);
  String filePath = cursor.getString(columnIndex);
  cursor.close();
  

  That selected file path is in variable filePath.