mobile

Documentation

Overview

Package mobile is the gomobile-bind entry point used by the iOS Swift app and the Android app. It wraps internal/web.Server so the HTTP server runs in-process via a JNI .so — no subprocess, no exec from nativeLibraryDir, no PIE/page-size/SELinux pitfalls.

Index

• type MessageNotifier
• type Server
  • func NewAndroidServer(dataDir string, preferredPort int) (*Server, error)
  • func NewAndroidUniversalServer(dataDir string, preferredPort int) (*Server, error)
  • func NewServer(dataDir string, preferredPort int) (*Server, error)
  • func (s *Server) Port() int
  • func (s *Server) SetMessageNotifier(n MessageNotifier)
  • func (s *Server) Stop()

Types

type MessageNotifier

type MessageNotifier interface {
	OnNewMessages(count int)
}

MessageNotifier is implemented on the native side (Kotlin/Swift). The Go background chat poll loop calls OnNewMessages when it discovers new messages, so the native app can post a system notification while it's backgrounded (the in-app, foreground case is handled by the web UI). The implementation must be cheap and non-blocking — it runs on a Go poll goroutine.

type Server

type Server struct {
	// contains filtered or unexported fields
}

Server is a running thefeed-client instance bound to 127.0.0.1.

func NewAndroidServer

func NewAndroidServer(dataDir string, preferredPort int) (*Server, error)

NewAndroidServer is NewServer for per-ABI APK builds: the update prompt points at the matching ABI asset.

func NewAndroidUniversalServer

func NewAndroidUniversalServer(dataDir string, preferredPort int) (*Server, error)

NewAndroidUniversalServer is NewServer for the universal APK build: the update prompt keeps the user on the universal asset.

func NewServer

func NewServer(dataDir string, preferredPort int) (*Server, error)

NewServer starts a server on 127.0.0.1. preferredPort=0 picks a kernel-assigned port; a positive value is tried first and falls back to kernel-assigned on bind failure. dataDir must be a writable app-private directory (e.g. NSDocumentDirectory on iOS).

func (*Server) Port

func (s *Server) Port() int

Port returns the listening port (0 after Stop).

func (*Server) SetMessageNotifier

func (s *Server) SetMessageNotifier(n MessageNotifier)

SetMessageNotifier registers (or, with nil, clears) the native new-message notifier. Safe to call after the server is running.

func (*Server) Stop

func (s *Server) Stop()

Stop closes the listener and waits for serve to return.