mirror of
https://git.sr.ht/~eliasnaur/gio
synced 2026-07-01 15:45:38 +00:00
Elias Naur
8688ed95c2
Do is a function for accessing the underlying Android View in a safe context, the main thread. Do is - more general than RegisterFragment and may be expanded to other platforms - simpler to implement (from the Gio side) and as a bonus, the Do implementation avoids a race condition where a call to RegisterFragment during an Activity re-create would be ignored. Signed-off-by: Elias Naur <mail@eliasnaur.com>
51 lines
1.6 KiB
Go
51 lines
1.6 KiB
Go
// SPDX-License-Identifier: Unlicense OR MIT
|
|
|
|
/*
|
|
Package permission includes sub-packages that should be imported
|
|
by a Gio program or by one of its dependencies to indicate that specific
|
|
operating-system permissions are required. For example, if a Gio
|
|
program requires access to a device's Bluetooth interface, it
|
|
should import "gioui.org/app/permission/bluetooth" as follows:
|
|
|
|
package main
|
|
|
|
import (
|
|
"gioui.org/app"
|
|
_ "gioui.org/app/permission/bluetooth"
|
|
)
|
|
|
|
func main() {
|
|
...
|
|
}
|
|
|
|
Since there are no exported identifiers in the app/permission/bluetooth
|
|
package, the import uses the anonymous identifier (_) as the imported
|
|
package name.
|
|
|
|
As a special case, the gogio tool detects when a program directly or
|
|
indirectly depends on the "net" package from the Go standard library as an
|
|
indication that the program requires network access permissions. If a program
|
|
requires network permissions but does not directly or indirectly import
|
|
"net", it will be necessary to add the following code somewhere in the
|
|
program's source code:
|
|
|
|
import (
|
|
...
|
|
_ "net"
|
|
)
|
|
|
|
Android -- Dangerous Permissions
|
|
|
|
Certain permissions on Android are marked with a protection level of
|
|
"dangerous". This means that, in addition to including the relevant
|
|
Gio permission packages, your app will need to prompt the user
|
|
specifically to request access. To access the Android Activity
|
|
required for prompting, use the Do method on Window. Do exposes
|
|
the underlying Android View, on which the getContext method returns
|
|
the Activity.
|
|
|
|
For more information on dangerous permissions, see:
|
|
https://developer.android.com/guide/topics/permissions/overview#dangerous_permissions
|
|
*/
|
|
package permission
|