android

README

microdbg-android

Allows you to emulate Android native libraries, based on MicroDbg

Thanks

• microdbg
• unidbg
• bionic
• unicorn
• usercorn

Documentation

Index

• Variables
• func SetOption(v Runtime, options ...Option) error
• type JNIContext
• type JNIEnv
• type Module
• type NativeMethod
• type Option
• type Package
• type Runtime
• type Symbol

Variables

var (
	ErrOptionUnsupported = errors.New("option unsupported")
	ErrMethodNotFound    = errors.New("method not found")
)

Functions

func SetOption

func SetOption(v Runtime, options ...Option) error

Types

type JNIContext

type JNIContext interface {
	ClassFactory() gava.ClassFactory
	Throw(java.IThrowable) java.JInt
	ExceptionOccurred() java.IThrowable
	ExceptionDescribe()
	ExceptionClear()
	FatalError(string)
}

type JNIEnv

type JNIEnv interface {
	DefineClass(JNIContext, string, java.IObject, []java.JByte) (java.IClass, error)
	FindClass(JNIContext, string) (java.IClass, error)
	ThrowNew(JNIContext, java.IClass, string) (java.JInt, error)
	GetMethod(JNIContext, java.IClass, string, string) (java.IMethod, error)
	GetField(JNIContext, java.IClass, string, string) (java.IField, error)
	GetStaticMethod(JNIContext, java.IClass, string, string) (java.IMethod, error)
	GetStaticField(JNIContext, java.IClass, string, string) (java.IField, error)
	NewString(JNIContext, []java.JChar) (java.IString, error)
	NewStringUTF(JNIContext, string) (java.IString, error)
	NewObjectArray(JNIContext, java.JSize, java.IClass, java.IObject) (java.IObjectArray, error)
	NewBooleanArray(JNIContext, java.JSize) (java.IBooleanArray, error)
	NewByteArray(JNIContext, java.JSize) (java.IByteArray, error)
	NewCharArray(JNIContext, java.JSize) (java.ICharArray, error)
	NewShortArray(JNIContext, java.JSize) (java.IShortArray, error)
	NewIntArray(JNIContext, java.JSize) (java.IIntArray, error)
	NewLongArray(JNIContext, java.JSize) (java.ILongArray, error)
	NewFloatArray(JNIContext, java.JSize) (java.IFloatArray, error)
	NewDoubleArray(JNIContext, java.JSize) (java.IDoubleArray, error)
}

type Module

type Module interface {
	io.Closer
	Name() string
	BaseAddr() uint64
	FindSymbol(name string) (Symbol, error)
	Symbols(yield func(Symbol) bool)
	CallEntry(ctx context.Context) error
	CallOnLoad(ctx context.Context) (java.JInt, error)
	FindNativeMethod(vm java.JavaVM, clazz java.IClass, name, sig string) (NativeMethod, error)
	Dump(w io.Writer) error
}

type NativeMethod

type NativeMethod = func(obj java.IObject, args ...any) any

type Option

type Option func(Runtime) error

type Package

type Package interface {
	Name() string
	Label() string
	Version() (name string, code int)
	UsesSdk() (min, target int)
	Permission() []string
	CodePath() string
	LibraryDir() string
	FilesDir() string
	Certificate() []*x509.Certificate
	LoadModule(ctx context.Context, art Runtime, name string) (Module, error)
}

type Runtime

type Runtime interface {
	io.Closer
	Debugger() debugger.Debugger
	Emulator() emulator.Emulator
	LoadModule(ctx context.Context, file fs.File) (Module, error)
	FindModule(name string) (Module, error)
	LinkFS(name string, fs filesystem.FS) error
	JavaVM() java.JavaVM
	Package() Package
	ClassFactory() gava.ClassFactory
	RegisterNatives(clazz java.IClass, methods []java.JNINativeMethod) java.JInt
	UnregisterNatives(clazz java.IClass) java.JInt
}

type Symbol

type Symbol interface {
	Name() string
	Address() uint64
	Call(ctx context.Context, calling debugger.Calling, ret any, args ...any) error
}