Intent System¶

Android Intents are used to start activities, send broadcasts, and communicate between apps. QSL4A provides full Intent support through the Intent module.

Module Import¶

import androidhelper
don = androidhelper.Android()

Intent Constants¶

Access via droid.Intent:

Actions¶

Constant	Value	Usage
`ACTION_MAIN`	android.intent.action.MAIN	App entry point
`ACTION_VIEW`	android.intent.action.VIEW	View content
`ACTION_EDIT`	android.intent.action.EDIT	Edit content
`ACTION_PICK`	android.intent.action.PICK	Pick item
`ACTION_SEND`	android.intent.action.SEND	Share content
`ACTION_SEARCH`	android.intent.action.SEARCH	Search

Flags¶

Constant	Value	Usage
`FLAG_ACTIVITY_NEW_TASK`	268435456	Start new task
`FLAG_ACTIVITY_CLEAR_TASK`	32768	Clear task stack
`FLAG_ACTIVITY_NEW_DOCUMENT`	524288	New document mode

Extras¶

Constant	Usage
`EXTRA_TEXT`	Text content
`EXTRA_STREAM`	File URI
`EXTRA_SUBJECT`	Subject line
`EXTRA_EMAIL`	Email address

Core Methods¶

makeIntent()¶

Create an Intent object.

makeIntent(action, uri=None, type=None, extras=None, categories=None,
           packagename=None, classname=None, flags=None)

Parameters: - action (str): Intent action (e.g., droid.Intent.ACTION_VIEW) - uri (str, optional): Data URI - type (str, optional): MIME type - extras (dict, optional): Extra data - categories (list, optional): Intent categories - packagename (str, optional): Target package - classname (str, optional): Target class - flags (int, optional): Intent flags

Returns: Intent object

startActivityIntent()¶

Start an Activity with an Intent.

startActivityIntent(intent, wait=None)

Parameters: - intent: Intent object from makeIntent() - wait (bool, optional): Block until activity closes

startActivityForResultIntent()¶

Start activity and wait for result.

startActivityForResultIntent(intent)

Returns: Activity result

sendBroadcastIntent()¶

Send a broadcast.

sendBroadcastIntent(intent)

view()¶

View content by URI.

view(uri, type=None, extras=None)

pick()¶

Pick content from URI.

pick(uri)

Helper Class: Uri¶

Create URI objects for Intents:

from androidhelper.Intent import Uri

uri = Uri("file:///sdcard/test.txt")

Usage Examples¶

Open Web Page¶

intent = droid.makeIntent(
    action=droid.Intent.ACTION_VIEW,
    uri="http://www.example.com"
).result
droid.startActivityIntent(intent)

intent = droid.makeIntent(
    action=droid.Intent.ACTION_SEND,
    extras={
        droid.Intent.EXTRA_TEXT: "Hello from QPython!",
        droid.Intent.EXTRA_SUBJECT: "Test"
    },
    type="text/plain"
).result
droid.startActivityIntent(intent)

Open File¶

intent = droid.makeIntent(
    action=droid.Intent.ACTION_VIEW,
    uri="file:///sdcard/document.pdf",
    type="application/pdf"
).result
droid.startActivityIntent(intent)

Pick Contact¶

result = droid.pickContact()
contact_uri = result.result

Send Email¶

intent = droid.makeIntent(
    action=droid.Intent.ACTION_SEND,
    extras={
        droid.Intent.EXTRA_EMAIL: ["test@example.com"],
        droid.Intent.EXTRA_SUBJECT: "Hello",
        droid.Intent.EXTRA_TEXT: "Message body"
    },
    type="message/rfc822"
).result
droid.startActivityIntent(intent)

Open App¶

intent = droid.makeIntent(
    action=droid.Intent.ACTION_MAIN,
    packagename="com.android.settings",
    classname="com.android.settings.Settings"
).result
droid.startActivityIntent(intent)