name: inverse layout: true class: center, middle, inverse --- # Activities and Intents, Revisited Lauren Bricker CSE 340 Spring 23 --- layout: false [//]: # (Outline Slide) # Today's Agenda - Administrivia - Undo code and video due Fri 19-May, 10pm - Undo reflection due Sun 21-May, 10pm - Final Project out Fri 19-May - Briefly review [23sp class Statistical Analysis of Menu Data](https://docs.google.com/spreadsheets/d/1JYRAPAQhsZTon_LVN8bBEaCeLC-KZ-PVqEpGaAtCa8o/edit#gid=488481442) - Undo Warm Up - Briefly review the "Whole Toolkit Architeture" - Intents - Revisit the Android Activity Lifecycle - Investigate using Intents to switch between Activities. --- # ❗🌡️ Warmup: Undo Do the warm up slide on [Ed](https://edstem.org/us/courses/38124/lessons//59441/slides/351896) (group work is ok) ![:youtube three minute timer, 81p4gO77fPg] --- # The Whole Toolkit Architecture You're going to be given a [piece of paper](https://docs.google.com/document/d/14hQ6cuEOpfnNpDxECEt_WyGmruwKWw1KssWyRu5hPbg/edit?usp=sharing) with three sections on it... Get out a writing implement! We're going to do a brain dump! --- # The Whole Toolkit Architecture - Input For 1 minute, write down everything you know about Input in Android ![:youtube one minute timer, mpvGJcdOQG0] -- count: false Share out! --- # The Whole Toolkit Architecture - Input For more information see the [The Whole Toolkit Architecture Part I - Input](whole-toolkit-i.html) slides and video .left-column50[ - Input models (events) ([🔗](/courses/cse340/23sp/slides/wk04/events.html#27)) - Event dispatch ([🔗](/courses/cse340/23sp/slides/wk05/event-handling.html#21)) - Input handling & state machines ([🔗](/courses/cse340/23sp/slides/wk05/pps-geom.html#46)) - Callbacks (listeners) to application ([🔗](/courses/cse340/23sp/slides/wk05/event-handling.html#11)) - Model and Controller ([🔗](/courses/cse340/23sp/slides/wk04/events.html#17)) - Sensors (this week) ] .right-column50[ - End User - Acts with the mouse, keyboard and other peripherals. - App Developer - Writes callbacks - Component Developer - Keeps track of a model - Writes controller - Uses listeners for separation of concerns ] --- # The Whole Toolkit Architecture - Output For 1 minute, write down everything you know about Output in Android ![:youtube one minute timer, mpvGJcdOQG0] -- count: false Share out! --- # The Whole Toolkit Architecture - Output For more information see the [The Whole Toolkit Architecture Part 2 - Output](whole-toolkit-ii.html) slides and video .left-column50[ - Interactor Hierarchy design & use ([🔗](/courses/cse340/23sp/slides/wk01/drawing.html#9)) - Drawing models (`onDraw()`) ([🔗](/courses/cse340/23sp/slides/wk02/layout.html#8)) - Layout (`onLayout()` or `XML`) ([🔗](/courses/cse340/23sp/slides/wk02/layout.html#25), [🔗](/courses/cse340/23sp/slides/wk03/layout-algorithm.html#1)) - Damage and redraw process ([🔗](/courses/cse340/23sp/slides/wk03/layout-algorithm.html#21)) ] .right-column50[ - End User - Changes views on the screen, to audio, etc. - App Developer - Uses Layouts - May call `invalidate()` - Component Developer - Develops new Layouts - Handles `onDraw` ] --- # The Whole Toolkit Architecture - Storage For 30 seconds, write down everything you know about Storage in Android ![:youtube one minute timer, mpvGJcdOQG0] -- count: false Share out! --- # The Whole Toolkit Architecture - Storage For more information see the [The Whole Toolkit Architecture Part 3 - Storage](whole-toolkit-iii.html) slides and video .left-column50[ - **Storage** [🔗](/courses/cse340/23sp/slides/wk03/storage.html#1) - Bundles - SharedPreferences ] .right-column50[ - End User - Pauses or unloads an app - App Developer - Reads the state in from a `Bundle` or `SharedPreferences` - Writes state out to a `Bundle` or `SharedPreferences` - Component Developer - Possibly listens for updates to the model of a component ] --- ## Review: Activity From our first class: [`android.app.Activity`](https://developer.android.com/reference/android/app/Activity) - Represents a single interface - Example: Activities for Gmail App - Inbox, Message Compose, Spam Folder, etc. - Activities can be started by other applications, if desired - E.g., sharing a photo by email starts Gmail's Message Compose activity --- ## Activity Lifecycle .left-column40[  ] .right-column60[ Recall where we have seen these states of our application ] -- .right-column60[ How do we switch between them? ] -- .right-column60[ Intents! ] --- # In class exercise: To motivate learning about using `Intent` we've created an exercise: <br> "Fake" - a fake log in system. Do this now - Clone the [CSE340 Intent Practice](https://gitlab.cs.washington.edu/cse340/exercises/cse340-intent-practice) repo - Make sure you're on the `main` branch - There is a `solution` branch but don't look yet. - Look through the repo - what do you see? .footnote[Special thanks to Davin Win Kyi who came up with the idea for this app] --- # Fake Layout Wireframes  --- # Fake Interactor Hierarchies  --- # Fake Navigation Flow  --- # Fake Screens |Main Activity | User List | Welcome Page | Web Page | | :--: | :--: | :--: | :--: | | |||| --- # Coding it up What we know * how to create Layouts using the Layout Manager and Code. * how to dynamically change text on the screen * how to use the values in our `.xml` files for good code quality * how to hook up click listeners to the buttons But do we know how to switch from one activity to another? -- count: false Sort of. We saw it in all of the other apps, just kind of overlooked it. --- # Intent "An intent is an abstract description of an operation to be performed." - A passive data structure for holding data - Used for launching activities - Provides a late runtime binding between the code in different applications --- # Intent Primary pieces of information in an `Intent` - **action** -- The general action to be performed, such as ACTION_VIEW, ACTION_EDIT, ACTION_MAIN, etc. - **data** -- The data to operate on, such as a person record in the contacts database, expressed as a Uri. --- # Intent Constructors ```java Intent() // Create an empty intent Intent(Intent o) // Copy constructor Intent(String action) // Create an intent with a given action Intent(String action, Uri uri) // Create an intent with a given action and // for a given data url Intent(Context packageContext, // Create an intent for a specific component Class<?> cls) // Intent(String action, Uri uri, // Create an intent for a specific component Context packageContext, // with a specified action and data Class<?> cls) // ``` --- # Examples: switching screens Let's say enters a new user name and password in the fields, then clicks the "Create New User" button. * set up the `onClickListener` * create an intent to go from `MainActivity.this` to `WelcomeActivity.this` ```java Button buttonCreate = findViewById(R.id.mainNewUsername); buttonCreate.setOnClickListener(v-> { // Create the intent to go from one screen to another. Intent intent = new Intent(MainActivity.this, UserListActivity.class); ... // switch to the new the activity startActivity(intent); ``` Do this every time you want to go from one `Activity` to another --- # Getting an intent from the Activity Each activity has an `Intent` object associated with it. So you simply can call `getIntent()` ```java public class MainActivity extends IntentActivity { ... protected void onCreate(Bundle savedInstanceState) { ... Intent myIntent = getIntent(); ... ``` --- # Transferring data Often you need data to transfer from one `Activity` to another as you switch * `Intent` objects can hold "extra" information in key value pairs * These are actually `Bundle` objects... * There are MANY methods to put extra information into the `Intent` extra, examples: ```java putExtra(String key, boolean value) putExtra(String key, char value) putExtra(String key, int value) // or long putExtra(String key, float value) // or double putExtra(String key, String value) // or anything Parceable putExtra(String key, int[] value) // or other array types ``` --- # Examples: putting data into the Intent An example of this is in `IntentActivity.java` ```java // Keys for adding to the Intent Extras public static final String COUNT_KEY = "count"; public static final String USER_KEY = "userinfo"; ... int count = /* count is initialized...*/ newIntent.putExtra(COUNT_KEY, count); ``` --- # Getting data from the Intent There are two ways to get the information back out from the Intent. 1. Ask the `Intent` for the "extras" (`Bundle`) and then use `Bundle` methods ```java String userInfo = getIntent().getExtras().getString(USER_KEY + i); ``` 2. Get the information using a method on the `Intent` directly ```java String userInfo = getIntent().getStringExtra(USER_KEY + i); ``` For `int` values you can specify a default value if the key/value pair does not exist such as `int count = getIntent().getIntExtra(COUNT_KEY, 0);` --- # Your job: Fill in the TODOs! 1. Start with `IntentActivity.java` and fill in the `copyIntentData` method that is used elsewhere in the project. 2. Then finish code in `MainActivity` to handle the two button listeners (one for going to the `UserListActivity`, the other to go to the `WelcomeActivity`) 3. Do the same for the click listener in `UserListActivity` and `WelcomeActivity` to go back to the `MainActivity` 4. Finally, follow the instructions in the `WelcomeActivity` to open up our CSE 340 web page in a browser by using an `Intent` --- # Helpful resources - Android [`Intent`](https://developer.android.com/reference/android/content/Intent) - For saving and getting data in intents [Stackoverflow](https://stackoverflow.com/questions/5265913/how-to-use-putextra-and-getextra-for-string-data) - How to use Intents [video](https://www.youtube.com/watch?v=OoPQnCgVM_A) - How to use a link in an intent on [Stackoverflow](https://stackoverflow.com/questions/3004515/sending-an-intent-to-browser-to-open-specific-url#:~:text=To%20open%20a%20URL%2Fwebsite,ACTION_VIEW)
