Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

android

package

Go to main page

Versions in this module

v2

v2.20.0

Oct 10, 2026

Changes in this version

type AppInfo

+ IsGame bool

+ type DeviceStatus struct

+ Bluetooth *hoststatus.Bluetooth

+ Controllers []hoststatus.Controller

+ Display *hoststatus.Display

+ Network *hoststatus.Network

+ Power *power.Detail

+ Storage []hoststatus.Volume

+ System *hoststatus.System

type Host

+ Interactive func() bool

type Platform

+ func (*Platform) PowerActions(context.Context) map[hoststatus.PowerAction]hoststatus.Availability

+ func (*Platform) PreparePowerAction(context.Context, hoststatus.PowerAction) (func() error, error)

+ func (p *Platform) DeviceBluetooth() (hoststatus.Bluetooth, error)

+ func (p *Platform) DeviceControllers() ([]hoststatus.Controller, error)

+ func (p *Platform) DeviceDisplay() (hoststatus.Display, error)

+ func (p *Platform) DeviceNetwork() (hoststatus.Network, error)

+ func (p *Platform) DevicePower() (power.Detail, error)

+ func (p *Platform) DeviceStorage() ([]hoststatus.Volume, error)

+ func (p *Platform) DeviceSystem() (hoststatus.System, error)

+ func (p *Platform) Interactive() bool

+ func (p *Platform) PowerStatus() (power.Status, error)

+ func (p *Platform) SetDeviceStatus(report *DeviceStatus)

+ func (p *Platform) SetDeviceStatusChanged(onChange func())

v2.19.0

Oct 2, 2026

Changes in this version

+ const StrategyApp

+ const StrategyContentURI

+ const StrategyFilesystemPath

+ var ErrAppIdentity = errors.New("invalid android app identity")

+ var ErrLaunchDefinition = errors.New("invalid or unsupported launch definition")

+ type AppIdentity struct

+ Name string

+ Package string

+ Variant string

+ func ParseAppPath(path string) (AppIdentity, error)

+ func (a AppIdentity) AppPath() string

+ type AppInfo struct

+ Activity string

+ Label string

+ Package string

+ type DispatchReceipt struct

+ Activity string

+ Package string

+ Strategy string

+ type FailureReason string

+ const FailureActivityUnavailable

+ const FailureCancelled

+ const FailureForegroundRequired

+ const FailureHostUnavailable

+ const FailureInvalidResponse

+ const FailureNotInstalled

+ const FailureOutcomeUnknown

+ const FailureProviderUnsupported

+ const FailureRefused

+ const FailureSourceRevoked

+ const FailureSourceUnavailable

+ const FailureStorageDenied

+ const FailureStorageUnmounted

+ const FailureStorageVersion

+ type ForegroundState struct

+ BootID string

+ ElapsedMs int64

+ Interactive bool

+ Permission string

+ SampledMs int64

+ Unlocked bool

+ Version int

+ type Host interface

+ AppIcon func(packageName string) (path string, err error)

+ Dispatch func(ctx context.Context, definition *LaunchDefinition, reference string, ...) (DispatchReceipt, error)

+ DispatchApp func(definition *LaunchDefinition) (DispatchReceipt, error)

+ ForegroundEvents func(ctx context.Context, launchID, target string, fromMs, toMs int64) (database.ForegroundEvidence, error)

+ ForegroundState func() (ForegroundState, error)

+ InspectTarget func(definition *LaunchDefinition) error

+ InstalledApps func() (apps []AppInfo, scanned bool)

+ InstalledCores func() (files []string, scanned bool)

+ MediaFolders func(ctx context.Context) ([]string, error)

+ ReadFile func(ctx context.Context, reference string, segments []string, limit int64) ([]byte, error)

+ ReadMediaDir func(ctx context.Context, reference string, segments []string) ([]platforms.SourceEntry, error)

+ type HostError struct

+ Reason FailureReason

+ func (e *HostError) Error() string

+ type HostReturn struct

+ ObserverStartedElapsedMs int64

+ ReturnedElapsedMs int64

+ ReturnedWallMs int64

+ type LaunchDefinition struct

+ Action string

+ Activity string

+ ClipData bool

+ Data string

+ DataSource string

+ Extensions []string

+ Extras []LaunchExtra

+ GrantReadURI bool

+ ID string

+ MaxTargetSDK int

+ Name string

+ Package string

+ Repair string

+ StorageAccess string

+ Strategy string

+ System string

+ Variant string

+ Version int

+ func (d *LaunchDefinition) Validate() error

+ type LaunchExtra struct

+ Name string

+ Source string

+ Suffix string

+ Type string

+ Value string

+ type Platform struct

+ func New(settings platforms.Settings, host Host) (*Platform, error)

+ func (*Platform) ConsoleManager() platforms.ConsoleManager

+ func (*Platform) ForwardCmd(*platforms.CmdEnv) (platforms.CmdResult, error)

+ func (*Platform) GamepadPress(string) error

+ func (*Platform) ID() string

+ func (*Platform) KeyboardPress(string) error

+ func (*Platform) LaunchSystem(*config.Instance, string) error

+ func (*Platform) LookupMapping(*tokens.Token) (string, bool)

+ func (*Platform) ManagedByPackageManager() bool

+ func (*Platform) ReturnToMenu() error

+ func (*Platform) RootDirs(*config.Instance) []string

+ func (*Platform) ScanHook(*tokens.Token) error

+ func (*Platform) Screenshot() (*platforms.ScreenshotResult, error)

+ func (*Platform) SetTrackedProcess(*os.Process)

+ func (*Platform) StartPre(*config.Instance) error

+ func (*Platform) StopActiveLauncher(platforms.StopIntent) error

+ func (*Platform) SupportedReaders(*config.Instance) []readers.Reader

+ func (p *Platform) InvalidateHostSnapshot()

+ func (p *Platform) LaunchMedia(cfg *config.Instance, path string, launcher *platforms.Launcher, ...) error

+ func (p *Platform) Launchers(*config.Instance) []platforms.Launcher

+ func (p *Platform) ReadSourceDir(ctx context.Context, path string) ([]platforms.SourceEntry, error)

+ func (p *Platform) ReadSourceFile(ctx context.Context, path string, limit int64) ([]byte, error)

+ func (p *Platform) ReconcileExternalSessions(ctx context.Context) error

+ func (p *Platform) ReconcileSessions(ctx context.Context, observed HostReturn) error

+ func (p *Platform) RefreshLauncherDependencies() error

+ func (p *Platform) Scrapers(*config.Instance) map[string]platforms.Scraper

+ func (p *Platform) SetMediaHistoryHooks(hooks platforms.MediaHistoryHooks)

+ func (p *Platform) Settings() platforms.Settings

+ func (p *Platform) SourceRoots(ctx context.Context) ([]string, error)

+ func (p *Platform) StartPost(ctx context.Context, _ *config.Instance, ...) error

+ func (p *Platform) Stop() error