coursera-android#

Time spent#

Day hours
2014-01-21 1
2014-01-22 1
2014-01-23 1
2014-01-25 2
2014-01-31 1
2014-02-01 2
2014-02-06 2
2014-02-12 1
2014-02-14 1
2014-02-15 2
2014-02-18 1
2014-02-19 2

TODO#

Weeks#

Week 1#

  • You can telnet to your emulator, the port is in the title of your emulator (5554).
  • manipulate device while logged in :
    • network speed edge or network speed full or power capacity 5 or power status not-charging or geo fix 0.00 40.00 or sms send 301555555 "test msg" , see here for more:
metskem@athena ~ $ telnet localhost 5554
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: type 'help' for a list of commands
OK
help
Android console command help:

    help|h|?         print a list of commands
    event            simulate hardware events
    geo              Geo-location commands
    gsm              GSM related commands
    cdma             CDMA related commands
    kill             kill the emulator instance
    network          manage network settings
    power            power related commands
    quit|exit        quit control session
    redir            manage port redirections
    sms              SMS related commands
    avd              control virtual device execution
    window           manage emulator window
    qemu             QEMU-specific commands
    sensor           manage emulator sensors

try 'help <command>' for command-specific help
OK
    • you can run multiple emulators, and one let call the other, the number is equal to the port number again
  • DDMS = Dalvik Debug Monitor Service
  • method tracing
  • logcat (cmdline syntax), for example:
adb -s emulator-5554 logcat WikiNotes:I *:S
    • -s emulator-5554 to select the (virtual) device, if you have more than one running
    • WikiNotes:I - Informational messages for tag WikiNotes
    • *:S - All other tags to Silent

week 2#

Four main building blocks in Android :

  • Activity - Interaction with user (input and output)
    • single focused task for the user
  • Service - Long running background stuff
    • for example the Music app
    • support interaction with remote processes
  • BroadcastReceiver - Receive and act upon events in Android
    • events are represented by the Intent class
    • only for Intents they have registered themselves for
  • ContentProvider - Provide services to applications (input and output)
    • store and share date
    • database style interface
    • handles interprocess comms

Non code (resource) files

  • res/values/*.xml - Strings, String arrays, Plurals
    • Accessed by other resources as @string/string_name
    • Accessed in Java as R.string.string_name
  • res/layout/*.xml
    • Accessed by other resources as @layout/layout_name
    • Accessed in Java as R.layout.layout_name

Activity

The Activity Lifecycle:

android-activity-lifecycle.png

  • Typical onCreate() workflow
    • Restore saved state (super.onCreate() )
    • Set content view
    • Initialize UI elements
    • Keep references to UI elements if necessary
    • Link UI elements to code actions

-- onRestart() , do specific stuff required after activity was stopped
-- onStart() , loading persistent application state
-- onResume() , start foreground-only actions
-- onPause() , shutdown foreground-only actions, save persistent stat
-- onStop() , cache state (may not be called when Android kills the activity)
-- onDestroy() , release activity resources (may not be called when Android kills the activity)

Activities are created by creating Intents, and passing these Intents to startActivity() or startActivityForResult() . Started activity can set the result with Activity.setResult().

AndroidManifest.xml

Contains:

  • Application Name
  • Components
  • Other
    • Required permissions
    • Application features
    • Minimum API level

week 3#

Intents

Intent is a data structure that represents:

  • an operation to be performed
  • an event that has occurred

Intent fields:

  • action - specifies the desired action (action_dial, action_edit, action_sync)
  • data - data associated with the intent, specified as a URI (Uri.parse("tel:0548512395")
  • category - additional info about components that can handle the intent (category_launcher or category_browser)
  • type - the mime type of the intent
  • component - the component that should receive the intent (always one activity)
  • extras - a Map of key-value pairs
  • flags - specify how intent should be handled, a few special flags: FLAG_ACTIVITY_NO_HISTORY (dont put activity in history stack) FLAG_DEBUG_LOG_RESOLUTION (extra logging when intent is processed)

Activity is a subclass of Context, so you can for example use new Intent(MyActivity.this, SecondActivity.class);

Two ways of Intent resolution:

  • explicit - the Intent has the "target" class name specified, the target Activity will be called directly
  • implicit - Android tries to match the Intent with the capabilities of the installed apps.

Implicit Intent resolution uses the following data of the Intent:

  • ACTION
  • DATA (URI and TYPE)
  • CATEGORY

Installed apps have intent-filters defined in their AndroidManifest.xml.
These filters can specify things like data, action, category and so on. If they want to react to implicit intents, they always have to specify the intent-filter category.DEFAULT.

If you want to know what's on your device (for example all intent filters) :

adb shell dumpsys package

Permissions

Android uses permissions to protect Resources, data and operations.

Applications can define their own permissions to protect their own resources (other apps are required to have those permissions). (permission tag) And applications can define the permissions they use themselves (uses-permission).

There are application-level permissions and component-level permissions, the latter take precedence.

And we have :

  • Activity permissions (used when calling startActivity() or startActivityForResult()
  • Service permissions (used when calling stop/start/bindService()
  • broadcastreceiver permissions (restricts which components can send and receive broadcasts)
  • contentprovider permissions (restricts which components can read/write data in a content provider)

Fragments

Introduced in Android 3.0 to better support larger screens (Tablets).
Fragments represent a portion of a UI within an Activity => multi-pane activities.
A single Fragment can be used across multiple activities.
The lifecycle of a Fragment is coordinated with the lifecycle of an Activity, but they also have their own lifecycle callbacks.
Fragment lifecycle states :

  • resumed - visible in running activity
  • paused - another activity is in the foreground and has focus, the containing activity is visible
  • stopped - the fragment is not visible

Fragment callbacks :

  • onAttach() - activity created
  • onCreate() - ...
  • onCreateView() - fragment sets up and returns a view
  • onActivityCreated() - containing activity has completed onCreate() and the fragment has been installed
  • onResume() - similar to activity
  • onStart() - similar to activity
  • onPause() - similar to activity
  • onStop() - similar to activity
  • onDestroyView() -
  • onDestroy() - release resources
  • onDetach() - null out refs to hosting Activity

Statically add Fragment to Activity by specifying them in the layout file, or programmatically using the FragmentManager.

week 4#

User Interfaces

The View is the place and the means to exchange information between the user and the Application.

View is the key building block. It occupies a rectangular space on the screen, they are responsible for drawing themselves and handling events.
Predefined Views:

  • Button simple button to perform some action
  • ToggleButton - checked/not-checked state, light indicator showing state
  • Checkbox - another kind of 2-state button
  • RatingBar - row of stars
  • AutoCompleteTextView - an editable text field that provides completion suggestions as you type text

Common View operations:

  • set visibility
  • set checked state
  • set listeners
  • set props like background, opacity, orientation
  • manage input focus

View Listener Interfaces:

  • OnClickListener
  • OnLongClicklistener
  • OnFocusChanged
  • OnKeyListener
  • many more...

Displaying Views

Views are organized as a tree, Views with child Views Android walks the View tree three times:

  1. measure all views
  2. layout views
  3. draw views

ViewGroups

ViewGroups are invisable that contain other Views , use it to group/organize Views and ViewGroups.

Predefined ViewGroups:

  • RadioGroup- contains a set of radio buttons
  • TimePicker -
  • DatePicker
  • WebView - a WebGroup that displays webpages
  • MapView
  • Gallery - displays a set of data that is horizontally scrollable, data is managed by an adapter
  • Spinner - a scrollable list of items, user can select one. Items are managed by a ListAdapter

Layouts are ViewGroups.

LinearLayout - less or more fixed order RelativeLayout - layout is relative TableLayout - child views are arranged in rows and columns GridView - 2-dimensional scrollable View

Menus and ActionBar

Activities support Menus (a quick way to access important functions). Activities can add items to the menu.

Menu types:

  • options menu (when the user presses the Menu key, old stuff), global for the whole application
  • context menu (view specific menu shown when user presses and holds the view)

Creating menus getMenuInflater() , and inflate with a context menu

ActionBar, similar to desktop applications, quick access to common operations . Multiple Activities and Fragments can add items there.

Dialogs:

  • AlertDialog
  • ProgressDialog
  • DatePickerDialog
  • TimePickerDialog

week 5#

Notifications

2 types of notifications, "Toast" messages, and Notifications at the status bar / drawer.

The second allowes for custom Notifications, with custom views, custom sounds, Autocancel or not, and the possibility for a "PendingIntent" that gets fired when the user clicks on the notification at the drawer. (See last part of the video, or the project NotificationStatusBarWithCustomView.

BroadcastReceiver

Base class for components that :

  • wait for and receive events
  • process and react to these events

BroadcastReceiver register the events (Intents) they are interested in. When an intent is being broadcast, the BroadcastReceiver gets it via it's onReceive() method.

Typical use case:

  • register BroadcastReceivers
  • Broadcast an Intent
  • Android delivers the Intent to registered recipients
  • BroadcastReceivers get (onReceive() ) and handle the Intent

Registering can be

  • statically via AndroidManifest.xml ( <receiver> and <intent-filter> elements ) => android:name specifies the classname of the receiver, android:permission declares the permission that is required for a sender application to broadcast this intent.
  • dynamically with code (registerReceive()), can be in 2 scopes: LocalBroadcastManager (this application) or Context (any application)

When sending a Broadcast Intent, you can specify a permission that Receivers should have in order to get the Intent .

Event Broadcast:

  • Normal - processing order undefined
  • Ordered - sequential processing in priority order ( sendOrderedBroadcasts())

And:

  • Sticky - Event is stored after initial broadcast, so Receivers can get it when they startup after the Intent was broadcast (for example for system state changes like battery level)
  • Non-Sticky - Event is discarded after initial broadcast

Debugging tips

  • have Android log extra information during the intent processing (Intent.setFlag(FLAG_DEBUG_LOG_RESOLUTION))
  • list dynamically registered BroadcastReceivers : adb shell dumpsys activity xx
  • list statically registered BroadcastReceivers : adb shell dumpsys package

When an intent is delivered to the onReceive(), two parms are passed:

  • the context in which the receiver is running
  • the intent

The process receiving the intent has high priority during onReceive() processing and runs on the main thread, so make it quick. If you have long running work, let it handle by a Service.

Receiver is not considered valid after onReceive() returns. Android might terminate the BroadcastReceiver . BroadcastReceivers can't wait for asynchronous callbacks, because they then migth already be gone. So no ShowDialogs and not startActivityForResult().

BroadcastReceivers can abort the broadcast, making the Intent unavailable to receivers lower in the prio. (abortBroadcast())

BroadcastReceivers can setResultData() to the broadcast, so each receiver can see what the previous receiver has done with the result.

With sticky intents, intents can "overwrite" older intents they match.

When a BroadcastReceiver registers itself, all Android cached sticky intents will be delivered to the broadcastreceiver, and one matching sticky intent is returned to the caller.

Threads, AsyncTasks and Handlers

Only the Thread that originally created a view hierarchy is allowed to touch these views !.