MagicNetworkExplorer

An Android library project (Eclipse) that provides a simple local (WiFi) network scan for devices. This project was developed in Eclipse using the Android ADT plugin for Eclipse using JDK 7.

Cloning MagicNetworkExplorer source from GitHub

Follow these steps to clone the source if you would like to use this project and/or contribute.

1. Switch to the Git Repository Exploring perspective in Eclipse.
2. Copy the URI for this project https://github.com/dream09/MagicNetworkExplorer.git.
3. Click Clone a Git Repository and paste the URI from step 2.
4. The Host and Repository path fields should populate automatically. Click Next >.
5. If you wish to use the latest stable version as a library for another project ensure the master branch is checked. If you wish to contribute to MagicNetworkExplorer ensure the develop branch is checked.
6. Make any changes you wish in the Local Destination dialogue (remember - short paths close to root and without spaces are recommended), and click Finish.
7. Wait for the repository to be cloned.
8. If you would like to use the latest stable version check out the latest tag, for example v1.0, by:
   • Right-click the repository and select Switch To → Other...
   • Select Tags → v1.0 (or whatever is the latest)
   • Click Checkout
9. Right-click the repository and select Import Projects....
10. Select the Use the New Project wizard option and click Finish.
11. Select Android Project from Existing Code under the Android folder and click Next >.
12. Click Browse and locate the project directory you cloned to in step 6 then click Finish.
13. Switch to the Java perspective.
14. Right-click the MagicNetworkExplorer project and click Properties.
15. Under Android options check the Is Library check box and click OK.

Using MagicNetworkExplorer

• Ensure your project is set to use this library project.

• Ensure your AndroidManifest.xml lists com.magic09.magicnetworkexplorer.MagicNetworkExplorer as an activity.

• Start the activity for a result sending the title you want displayed in the action bar, for example:

Intent intent = new Intent(getActivity(), MagicNetworkExplorer.class);
intent.putExtra(MagicNetworkExplorer.KEY_SEND_TITLE, "My App Title");
startActivityForResult(intent, MagicNetworkExplorer.NETWORK_REQUEST);

• Handle the return using onActivityResult, for example:

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    	if (requestCode == MagicNetworkExplorer.NETWORK_REQUEST && resultCode == Activity.RESULT_OK) {
			if (data.hasExtra(MagicNetworkExplorer.KEY_RETURN_IPADDRESS)) {
				String selectedIP = data.getExtras().getString(MagicNetworkExplorer.KEY_RETURN_IPADDRESS);
			}
			if (data.hasExtra(MagicNetworkExplorer.KEY_RETURN_NAME)) {
				String selectedName = data.getExtras().getString(MagicNetworkExplorer.KEY_RETURN_NAME);
			}
		}
}