Exam 2 Review. Akhilesh Tyagi

Transcription

1 Exam 2 Review Akhilesh Tyagi

2 Design Flexibility An example of how two UI modules defined by fragments can be combined into one activity for a tablet design, but separated for a handset design

3 Using fragments in activity XML Activity layout XML can include fragments. <! activity_name.xml > <LinearLayout...> <fragment... android:name="classname1" /> <fragment... android:name="classname2" /> </LinearLayout> Marty Stepps, Stanford CS193A

4 Fragment Lifecycle

5 public class MySkeletonFragment extends Fragment { // Called when the Fragment is attached to its parent public void onattach(activity activity) { super.onattach(activity); // Get a reference to the parent Activity. // Called to do the initial creation of the public void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); // Initialize the Fragment.

6 oncreate(): The system calls this when creating the fragment. Within your implementation, you should initialize essential components of the fragment that you want to retain when the fragment is paused or stopped, then resumed. oncreateview(): The system calls this when it's time for the fragment to draw its user interface for the first time. To draw a UI for your fragment, you must return a View from this method that is the root of your fragment's layout. You can return null if the fragment does not provide a UI.

7 // Called once the Fragment has been created in order for it to // create its user public View oncreateview(layoutinflater inflater, ViewGroup container, Bundle savedinstancestate) { // Create, or inflate the Fragment's UI, and return it. // If this Fragment has no UI then return null. return inflater.inflate(r.layout.my_fragment, container, false); Resource file my_fragment.xml Should the inflated layout be attached To the container?

8 Fragment template public class Name extends Fragment public View oncreateview(layoutinflater inflater, ViewGroup vg, Bundle bundle) { // load the GUI layout from the XML return inflater.inflate(r.layout.id, vg, false); public void onactivitycreated(bundle savedstate) { super.onactivitycreated(savedstate); //... any other GUI initialization needed // any other code (e.g. event handling) Marty Stepps, Stanford CS193A

9 // Called at the start of the visible public void onstart(){ super.onstart(); // Apply any required UI change now that the Fragment is visible. // Called at the start of the active public void onresume(){ super.onresume(); // Resume any paused UI updates, threads, or processes required // by the Fragment but suspended when it became inactive.

10 // Called at the end of the active public void onpause(){ // Suspend UI updates, threads, or CPU intensive processes that don't //need to be updated when the Activity isn't the active foreground // activity. Persist all edits or state changes as after this call the process is likely to be killed. super.onpause(); // Called to save UI state changes at the // end of the active public void onsaveinstancestate(bundle savedinstancestate) { // Save UI state changes to the savedinstancestate. // This bundle will be passed to oncreate, oncreateview, and // oncreateview if the parent Activity is killed and restarted. super.onsaveinstancestate(savedinstancestate);

11 XML Fragment layouts Fragment element well suited for static layouts If the layout is to be dynamically modified in the program, use containers to pass to fragment managers.

12 <?xml version="1.0" encoding="utf 8"?> <LinearLayout android:layout_height="match_parent" android:layout_width="match_parent" android:orientation="horizontal" xmlns:android=" "> <FrameLayout android:layout_height="match_parent" android:layout_width="match_parent" android:layout_weight="1" <FrameLayout android:layout_height="match_parent" android:layout_width="match_parent" android:layout_weight="3" </LinearLayout>

13 Fragment Transactions To add, remove, and replace fragments within an activity. FragmentManager fragmanager = getfragmentmanager(); FragmentTransaction transaction = fragmanager.begintransaction(); transaction.add(r.id.container, firstfragment); transaction.commit();

14 public class MyFragmentActivity extends Activity { public void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); // Inflate the layout containing the Fragment containers setcontentview(r.layout.fragment_container_layout); FragmentManager fm = getfragmentmanager(); // Check to see if the Fragment back stack has been populated // If not, create and populate the layout. DetailsFragment detailsfragment = (DetailsFragment) fm.findfragmentbyid(r.id.details_container);

15 if (detailsfragment == null) { FragmentTransaction ft = fm.begintransaction(); ft.add(r.id.details_container, new DetailsFragment()); ft.add(r.id.ui_container, new MyListFragment()); ft.commit();

16 Fragment vs. activity Fragment code is similar to activity code, with a few changes: Many activity methods aren't present in the fragment, but you can call getactivity to access the activity the fragment is inside of. Button b = (Button) findviewbyid(r.id.but); Button b = (Button) getactivity().findviewbyid(r.id.but); Sometimes also use getview to refer to the activity's layout Event handlers cannot be attached in the XML any more. : ( Must be attached in Java code instead. Passing information to a fragment (via Intents/Bundles) is trickier. The fragment must ask its enclosing activity for the information. Fragment initialization code must be mindful of order of execution. Does it depend on the surrounding activity being loaded? Etc. Typically move oncreate code to onactivitycreated. Marty Stepps, Stanford CS193A

17 Fragment onclick listener Activity: <Button android:onclick="onclickb1"... /> Fragment: <Button /> // in fragment's Java file Button b = (Button) getactivity().findviewbyid(r.id.b1); b.setonclicklistener(new View.OnClickListener() public void onclick(view view) { // whatever code would have been in onclickb1 ); Marty Stepps, Stanford CS193A

18 Communicating with the Activity a fragment can access the Activity instance with getactivity() and easily perform tasks such as find a view in the activity layout: View listview = getactivity().findviewbyid(r.id.list); activity can call methods in the fragment by acquiring a reference to the Fragment from FragmentManager, using findfragmentbyid() ExampleFragment fragment = (ExampleFragment) getfragmentmanager().findfragmentbyid(r.id.exampl e_fragment);

19 Fragment that accepts parameters public class Name extends Fragment public View oncreateview(layoutinflater inflater, ViewGroup container, Bundle savedinstancestate) { return inflater.inflate(r.layout.name, container, public void onactivitycreated(bundle savedstate) { super.onactivitycreated(savedstate); // extract parameters passed to activity from intent Intent intent = getactivity().getintent(); int name1 = intent.getintextra("id1", default); String name2 = intent.getstringextra("id2", "default"); // use parameters to set up the initial state... Marty Stepps, Stanford CS193A

20 Communication between fragments One activity might contain multiple fragments. Thefragmentsmaywanttotalktoeachother. Use activity's getfragmentmanager method. its findfragmentbyid method can access any fragment that has an id. Activity act = getactivity(); if (act.getresources().getconfiguration().orientation == Configuration.ORIENTATION_LANDSCAPE) { // update other fragment within this same activity FragmentClass fragment = (FragmentClass) act.getfragmentmanager().findfragmentbyid(r.id.id); fragment.methodname(parameters); Marty Stepps, Stanford CS193A

21 Intents

22 Intents intent: a bridge between activities; a way for one activity to invoke another theactivitycanbeinthesameapporinadifferentapp can store extra data to pass as "parameters" to that activity second activity can "return" information back to the caller if needed Marty Stepps, CS193A, Stanford

23 Intent Object The main information that can be contained in an intent object : Component name: The name of the component that should handle the intent. Action: An action to be preformed such as initiating a phone call in an activity or handling a low battery warning in a broadcast. Data: Data to be acted on. Category: Additional information about the component handling the intent such as a widget, home, preference. Extras: Key value pairs containing additional information that should be passed to the component. Flags: These are contained in the intent API and have many different functions for the system on how to handle the intent.

24 Using Intents to Launch Activities To open a different application screen (Activity) in your application, call startactivity, passing in an Intent startactivity(myintent); The Intent can either explicitly specify the class to open, or include an action that the target should perform. Run time will choose the implicit Activity to open with Intent resolution.

25 Intent Resolution Intents can be divided into two groups: Explicit intents: These designate a component by name and are generally used locally for internal messages. Implicit intents: Do not name a target and are generally used by outside applications. For implicit intents the Android system will search components using intent filters to find the best match.

26 Implicit Intents and Late Runtime Binding Implicit Intents are a mechanism that lets anonymous application components service action requests. implicit Intent to use with startactivity, specifies an action to perform and, optionally, supplies the data on which to perform that action. if (foundphonenumer) { Intent intent = new Intent(Intent.ACTION_DIAL, Uri.parse( tel: )); startactivity(intent);

27 Extracting extra data In the second activity that was invoked, you can grab any extra data that was passed to it by the calling activity. You can access the Intent that spawned you by calling getintent. The Intent has methods like getextra, getintextra, getstringextra, etc. to extract any data that was stored inside the intent. public class SecondActivity extends Activity {... public void oncreate(bundle savedstate) { super.oncreate(savedstate); setcontentview(r.layout.activity_second); Intent intent = getintent(); String extra = intent.getextra("name");... Marty Stepps, CS193A, Stanford

28 Explicit Intent with Data/Arguments Intent i = new Intent(this, ActivityB.class); i.putextra("mystring1", "This is a message for ActivityB"); i.putextra("myint1", 100); startactivity(i); The data is received at the target activity as part of a Bundle object which can be obtained via a call to getintent().getextras(). ActivityB retrieves the data: Bundle extras = getintent().getextras(); if (extras!= null) { String mystring = extras.getstring("mystring1"); int myint = extras.getint("myint1");

29 Intents and Manifests <?xml version="1.0" encoding="utf 8"?> <manifest xmlns:android=" package="com.ebookfrenzy.intent1" android:versioncode="1" android:versionname="1.0" > <uses sdk android:minsdkversion="10" /> <application > <activity android:name="activitya" > <intent filter > <action android:name="android.intent.action.main" /> <category android:name="android.intent.category.launcher" /> </intent filter> </activity> <activity android:name="activityb" android:label="activityb" > </activity> </application> </manifest>

30 Subactivity ActivityB returns the result with: public void finish() { Intent data = new Intent(); data.putextra("returnstring1", "Message to parent activity"); setresult(result_ok, data); super.finish();

31 ActivityA receiving results protected void onactivityresult(int requestcode, int resultcode, Intent data) { String returnstring; if (resultcode == RESULT_OK && requestcode == REQUEST_CODE) { if (data.hasextra("returnstring1")) { returnstring = data.getextras().getstring("returnstring1");

32 Intent Filters Because intent filters must be seen by the Android system before launching a component; they are often placed in the Android Manifest file instead of Java Code. Implicit intents are tested against three filters of a component to see if they are correct. Action Category Data

33 Actions ACTION_CALL activity Initiate a phone call. ACTION_EDIT activity Display data for the user to edit. ACTION_MAIN activity Start up as the initial activity of a task, with no data input and no returned output. ACTION_SYNC activity Synchronize data on a server with data on the mobile device. ACTION_BATTERY_LOW broadcast receiver A warning that the battery is low. ACTION_HEADSET_PLUG broadcast receiver A headset has been plugged into the device, or unplugged from it. ACTION_SCREEN_ON broadcast receiver The screen has been turned on. ACTION_TIMEZONE_CHANGED broadcast receiver The setting for the time zone has changed.

34 Category category Use the android:category attribute to specify under which circumstances the action should be serviced ALTERNATIVE: The alternative category specifies that this action should be available as an alternative to the default action. BROWSABLE: Specifies an action available from within the browser

35 DEFAULT: Set this to make a component the default action. This is also necessary for Activities that are launched using an explicit Intent GADGET: By setting the gadget category, you specify that this Activity can run embedded inside another Activity. HOME: The home Activity is the first Activity displayed when the device starts LAUNCHER: Using this category makes an Activity appear in the application launcher.

36 Data Data tag specifies the data types handled by this component. android:host specifies a valid host name (iastate.edu) android:mimetype android:path valid path values for URIs android:port valid ports for a host

37 Intent Filter Example <activity android:name=.earthquakedamageviewer android:label= View Damage > <intent filter> <action android:name= com.paad.earthquake.intent.action.show_dam AGE > </action> <category android:name= android.intent.category.default /> <category android:name= android.intent.category.alternative_selected /> <data android:mimetype= vnd.earthquake.cursor.item/* /> </intent filter> </activity>

38 Listening for Broadcasts with Broadcast Receivers public class MyBroadcastReceiver extends BroadcastReceiver public void onreceive(context context, Intent intent) { //TODO: React to the Intent received. To enable a Broadcast Receiver, it needs to be registered, either in code or within the application manifest. When registering a Broadcast Receiver, you must use an Intent Filter to specify which Intents it is listening for.

39 public class LifeformDetectedBroadcastReceiver extends BroadcastReceiver { public static final String BURN = com.paad.alien.action.burn_it_with_fire public void onreceive(context context, Intent intent) { // Get the lifeform details from the intent. Uri data = intent.getdata(); String type = intent.getstringextra( type ); double lat = intent.getdoubleextra( latitude, 0); double lng = intent.getdoubleextra( longitude, 0); Location loc = new Location( gps ); loc.setlatitude(lat); loc.setlongitude(lng); if (type.equals( alien )) { Intent startintent = new Intent(BURN, data); startintent.putextra( latitude, lat); StartIntent.putExtra( longitude, lng); context.startactivity(startintent);

40 Registering Broadcast Receivers in Application Manifest <receiver android:name=.lifeformdetectedbroadcastrec eiver > <intent filter> <action android:name= com.paad.action.new_lif EFORM /> </intent filter> </receiver>

41 Registering Broadcast Receivers in Code // Create and register the broadcast receiver. IntentFilter filter = new IntentFilter(NEW_LIFEFORM_DETECTED); LifeformDetectedBroadcastReceiver r = new LifeformDetectedBroadcastReceiver(); registerreceiver(r, filter);

42 Preferences storage A SharedPreferences object points to a file containing key value pairs and provides simple methods to read and write them. getsharedpreferences() Use this if you need multiple shared preference files identified by name, which you specify with the first parameter. You can call this from any Context in your app. getpreferences() Use this from an Activity if you need to use only one shared preference file for the activity. Because this retrieves a default shared preference file that belongs to the activity, you don't need to supply a name.

43 SharedPreferences files accesses the shared preferences file that's identified by the resource string R.string.preference_file_key and opens it using the private mode so the file is accessible by only your app. When naming your shared preference files, you should use a name that's uniquely identifiable to your app, such as "com.example.myapp.preference_file_key" Context context = getactivity(); SharedPreferences sharedpref = context.getsharedpreferences( getstring(r.string.preference_file_key), Context.MODE_PRIVATE);

44 Nameless Activity SharedPrerences file SharedPreferences sharedpref = getactivity().getpreferences(context.mode_p RIVATE); If you create a shared preferences file with MODE_WORLD_READABLE or MODE_W ORLD_WRITEABLE, then any other apps that know the file identifier can access your data.

45 SharedPreferences sharedpref = getactivity().getpreferences (Context.MODE_PRIVATE); SharedPreferences.Editor editor = sharedpref.edit(); editor.putint(getstring(r.string.saved_high_score), newhighscore); editor.putboolean( istrue, true); editor.putfloat( lastfloat, 1f); editor.putint( wholenumber, 2); editor.putlong( anumber, 31); editor.putstring( textentryvalue, Not Empty ); editor.commit();

46 Read from Shared Preferences call methods such as getint() and getstring(), providing the key for the value you want, and optionally a default value to return if the key isn't present SharedPreferences sharedpref = getactivity().getpreferences(context.mode_private); int defaultvalue = getresources().getinteger(r.string.saved_high_score_ default); long highscore = sharedpref.getint(getstring(r.string.saved_high_score), defaultvalue);

47 boolean istrue = mysharedpreferences.getboolean( istrue, false); float lastfloat = mysharedpreferences.getfloat( lastfloat, 0f); int wholenumber = mysharedpreferences.getint( wholenumber, 1); long anumber = mysharedpreferences.getlong( anumber, 0); stringpreference = mysharedpreferences.getstring( textentryvalue, );

48 Multiple preference files You can call getsharedpreferences and supply a file name if you want to have multiple pref. files for the same activity: SharedPreferences prefs = getsharedpreferences( "filename", MODE_PRIVATE); SharedPreferences.Editor prefseditor = prefs.edit(); prefseditor.putint("name", value); prefseditor.putstring("name", value);... prefseditor.commit(); Marty Stepps, CS193A, Stanford

49 msensormanager = (SensorManager) getsystemservice(context.sensor_service); if (msensormanager.getdefaultsensor(sensor.type_gravity)!= null){ List<Sensor> gravsensors = msensormanager.getsensorlist(sensor.type_gravity); for(int i=0; i<gravsensors.size(); i++) { if ((gravsensors.get(i).getvendor().contains("google Inc.")) && (gravsensors.get(i).getversion() == 3)){ // Use the version 3 gravity sensor. msensor = gravsensors.get(i);

50 else{ // Use the accelerometer. if (msensormanager.getdefaultsensor(sensor.type_accelerometer)!= null){ msensor = msensormanager.getdefaultsensor(sensor.type_accelerometer); else{ // Sorry, there are no accelerometers on your device. // You can't play this game.

51 public class SensorActivity extends Activity implements SensorEventListener { private SensorManager msensormanager; private Sensor public final void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.main); msensormanager = (SensorManager) getsystemservice(context.sensor_service); mlight = msensormanager.getdefaultsensor(sensor.type_light);

52 Putting it all together Accelerometer public class sensorexample extends Activity implements SensorEventListener { private SensorManager sensensormanager; private Sensor protected void oncreate(bundle savedinstancestate) { Reference to system sensor service Reference to default accelerometer Need to check if it exists super.oncreate(savedinstancestate); setcontentview(r.layout.activity_sensorexample); sensensormanager = (SensorManager) getsystemservice(context.sensor_service); senaccelerometer = sensensormanager.getdefaultsensor(sensor.type_accelerometer); sensensormanager.registerlistener(this, senaccelerometer, SensorManager.SENSOR_DELAY_NORMAL); Register the listener to call back when sensor event occurs

53 Called when accelerometer registers a new event such as motion along any public void onsensorchanged(sensorevent sensorevent) { Sensor mysensor = sensorevent.sensor; if (mysensor.gettype() == Sensor.TYPE_ACCELEROMETER) { float x = sensorevent.values[0]; float y = sensorevent.values[1]; float z = public void onaccuracychanged(sensor sensor, int accuracy) { Acceleration values along the three axis

54 protected void onpause() { super.onpause(); sensensormanager.unregisterlistener(this); Important Sensors drain battery resource. Sensors keep acquiring data during onpause if not unregistered protected void onresume() { super.onresume(); sensensormanager.registerlistener(this, senaccelerometer, SensorManager.SENSOR_DELAY_NORMAL); Re-register Sensorevent listener to continue acquiring data during onresume