Fyne 项目实战-项目开发必备基础知识

. 移动端适配

网站差距处理

// 来源: OnlineExamApp/utils/sqlite.go
func GetConnection {
sysType := GetGoos
if sysType == "windows" {
dbName = "./data.db3" // Windows 使用当前目录
}
if sysType == "android" {
// Android 使用应用私有存储方法
dbName = "/data/data/com.example.onlineexamapp/files/data.db3"
}
db,err := sql.Open
return db。err
}

Android 打包配置

Fyne 项目打包为 Android APK 的常见步骤：

# 1️⃣ 安装 Android SDK & NDK
# 2️⃣ 使用 fyne CLI 打包
fyne package -os android -appID com.example.myapp -icon icon.png
# 3️⃣ 生成 .apk 并直接安装到设备
fyne install -os android

设备与 UI 线程

import "fyne.io/fyne/v2"
// 判断运行环境
if fyne.CurrentDevice.IsMobile {
// 移动端布局适配
} else if fyne.CurrentDevice.IsBrowser {
// WebAssembly 环境适配
} else {
// 桌面端默认行为
}
// 在非 UI 线程安全更新 UI
fyne.Do {
statusLabel.SetText
})

. CGO 与原生网站集成

CGo 是 Go 调用 C/NDK 代码的桥梁。当需要直接访问 Android NDK 摄像头、JNI WebView 或 Windows Win32 API 时CGo 是唯一可行方案。本节代码均来源于实战项目 FyneCamera 与 FyneWebView.

CGo 基础概念

. C 代码嵌入与编译指令

// 来源: FyneCamera/scanner/camera_android.go
说到//go，build android &&!ios // 仅在 Android 编译
/*
#cgo LDFLAGS: -lcamera2ndk -lmediandk -llog -landroid
#undef __ANDROID_API__
#define __ANDROID_API__ 28 // 强制使用 API 28，以便暴露 Camera2 符号
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
// 日志宏
#define LOG_TAG "fyne_camera"
#define LOGI __android_log_print
#define LOGE __android_log_print
// Go 可调用的辅助日志函数
static void goLog {
__android_log_print;}
/* 相机上下文结构体 —— 管理 NDK Camera2 全局状态 */
typedef struct {
ACameraManager* manager;ACameraDevice* device;AImageReader* imageReader;ACameraCaptureSession* session;ANativeWindow* window;ACaptureRequest* request;int width，int height;int camera_opened;int session_ready;int closing，老实说，int sensor_orientation;/* 帧缓冲 —— 线程安全 */
pthread_mutex_t lock;pthread_cond_t cond;uint8_t* frame_data;// Y 平面数据
int frame_len;int frame_width;int frame_height;老实说，int has_frame;} CameraCtx，*/
import "C"

. C.CString / C.free 内存管理模式

import "unsafe"
// 检查权限是否已授予
func CheckPermission bool {
// Go string → C 字符串
cPerm := C.CString
defer C.free) // 必须释放。防止泄漏
return C.check_permission == permGranted
}
// 请求权限
func RequestPermission {
cPerm := C.CString
defer C.free)
C.request_permission
}
// 将日志输出到 Android logcat
func Log {
cMsg := C.CString
defer C.free)
C.goLog
}

. 数据类型映射速查

Go 类型	C 类型	用途
C.int	int	整型传递
C.uint8_t	uint8_t	字节/像素数据
*C.uint8_t	uint8_t*	字节数组指针
*C.char	char*
unsafe.Pointer	void*	通用指针转换
C.JNIEnv	JNIEnv*	JNI 环境指针
C.jobject	jobject	JNI 对象引用
*C.JavaVM	JavaVM*	Java 虚拟机指针

Ndk Camera2 摄像头集成

. 完整管道架构概览

ACameraManager → ACameraDevice → AImageReader → ACaptureSession → 帧回调
↓
on_image_available
↓
g_ctx.frame_data
↓
Go的观点是，pollFrame → Frame 结构体

. 相机初始化关键代码片段

// 来源: FyneCamera/scanner/camera_android.go
static int camera_init{
pthread_mutex_init;
pthread_cond_init;
g_ctx.width=width;g_ctx.height=height;/* 创建相机管理器 */
g_ctx.manager=ACameraManager_create;/* 选择后置摄像头 */
char *cam_id=NULL;int orientation=0;select_back_camera_id;g_ctx.sensor_orientation=orientation;/* 打开摄像头设备 */
ACameraDevice_StateCallbacks device_cbs={0};device_cbs.onDisconnected=on_device_disconnected;device_cbs.onError=on_device_error;怎么说呢，ACameraManager_openCamera(g_ctx.manager。cam_id,&device_cbs,&g_ctx.device);free，按理说，g_ctx.camera_opened=1;/* 创建 ImageReader */
AImageReader_new(width,height。AIMAGE_FORMAT_YUV_420_888,MAX_FRAMES,&g_ctx.imageReader);/* 设置帧回调 */
AImageReader_ImageListener listener={0};listener.onImageAvailable=on_image_available;AImageReader_setImageListener;不过，/* 获取原生窗口句柄用于预览 */
AImageReader_getWindow;/* 创建 CaptureSession 并绑定窗口 */
ACaptureSessionOutputContainer_create;ACaptureSessionOutput_create;ACaptureSessionOutputContainer_add;ACameraDevice_createCaptureSession(g_ctx.device。outputs,NULL,&g_ctx.session);/* 创建预览请求并启动连续捕获 */
ACameraDevice_createCaptureRequest(g_cls.device。TEMPLATE_PREVIEW,&;g _ctx .request );ACam eraOutputTarget_create;ACaptureRequest_addTarget;ACameraCaptureSession_setRepeatingRequest(g _ctx .session。NULL,REPEAT_COUNT,& g _ctx .request,NULL );/* 等待会话激活信号 */
pthread_mutex_lock;while {
pthread_cond_wait(& amp;不过，g _ ctx . cond,& amp;g _ ctx . lock );}
pthread_mutex_unlock;return 0，话说回来，}

. 帧回调实现要点
\
\
\
\
\
\
\
c
// 来源：FyneCamera/scanner/camera_android.go
static void on_image_available{
// 防止关闭后仍写入全局缓存
pthread_mutex_lock;if {pthread_mutex_unlock;return，}
pthread_mutex_unlock;// 获取最新图像对象
AImage *image=NULL;AImageReader_acquireLatestImage;// 提取 Y 平面用于二维码解码等场景
uint8_t *y_data=NULL;int y_len=0，AImage_getPlaneData;// 将数据拷贝到全局缓冲区，保持线程安全
pthread_mutex_lock;说起来，if {
if free;g _ ctx .frame_data =malloc;memcpy，g _ ctx .frame_len=y_len;g _ ctx.has_frame =1;
}
pthread_mutex_unlock;AImage_delete;}

. Go 层封装示例
\
go
// 来源：FyneCamera/scanner/camera_android.go
type androidCamera struct{
width。height int
}
func openCamera{
if rc:=C.camera_init,C.int);rc，=0{
return nil,errors.New
}
return &androidCamera{width。height},nil
}
// pollFrame 从 native 缓冲区获取最新帧，返回 nil 表示无新帧。func pollFrame*Frame{
var data *C.uint8_t
var length,w,h C.int
if C.camera_get_frame==0{
return nil
}
f:=&Frame{
再看Width，int,Height:int,Data:C.GoBytes,int),Format:FormatGray,Orientation:int)。}
C.free)
return f
}
// close 完整资源释放顺序
func close{
C.camera_close
}

\

. 动态获取 JNI 环境<\/h5>
\
c
// 来源：FyneCamera/scanner/camera_android.go
typedef jint;static JNI_GetCreatedJavaVMs_t load_get_created_java_vms{
JNI_GetCreatedJavaVMs_t fn=
dlsym;ifreturn fn，
 const char *libs={"libnativehelper.so"。"libart.so","libartd.so","libjvm.so",NULL};for{
void *handle=dlopen;if{
fn=dlsym;ifreturn fn，}
}
return NULL;

}

/* 获取当前线程 JNIEnv；若未附着则自动 AttachCurrentThread /
static JNIEnv getjnienv{
static JNIGetCreatedJavaVMst getvms=NULL;if{ getvms=loadgetcreatedjavavms;不过，ifreturn NULL;}
 JavaVM *vm=NULL;jint rc=get_vms;ifreturn NULL;JNIEnv *env=NULL;rc=->GetEnv&env,JNI_VERSION_1_6);if{
rc=->AttachCurrentThread&env,NULL);ifreturn NULL;}
return env;话说回来，

}



. 权限检查与请求<\/h5>
\
c
// 检查权限 – 返回 PackageManager.PERMISSIONGRANTED / DENIED
static int checkpermission{
JNIEnv *env=getjnienv;ifreturn -1，

 jclass activityThreadCls = ->FindClass;jmethodID curAppMid = ->GetStaticMethodID(env。activityThreadCls,"currentApplication","Landroid/app/Application;")，jobject appObj = ->CallStaticObjectMethod(env。activityThreadCls,curAppMid);按理说，jclass contextCls = ->FindClass;jmethodID checkMid = ->GetMethodID(env。contextCls,"checkSelfPermission","I");jstring permStr = ->NewStringUTF;jint result = ->CallIntMethod(env。appObj,checkMid,permStr);->DeleteLocalRef;老实说，/* 防止引用表溢出 */
return result;

/* 使用 ActivityThread + Reflection 获得当前 Activity 并请求权限 */
static jobject getcurrentactivity{
jclass atCls = ->FindClass;jmethodID catMid = ->GetStaticMethodID(env,atCls。"currentActivityThread","Landroid/app/ActivityThread;")，jobject atObj = ->CallStaticObjectMethod(env。atCls,catMid);
 jfieldID mActivitiesFID = ->GetFieldID(env。atCls,"mActivities","Landroid/util/ArrayMap;")，jobject actsMap = ->GetObjectField(env。atObj,mActivitiesFID);/* 遍历 ArrayMap 获得第一个 Activity 实例 */
jclass mapCls = ->FindClass;jmethodID valuesMid = ->GetMethodID(env。mapCls,"values","Ljava/util/Collection;")，jobject colObj = ->CallObjectMethod(env。actsMap,valuesMid);jclass collCls=* env->FindClass env,"java/util/Collection");

...



\

"FyneWebView" 项目通过 CGO+JNI 将原生 WebView 覆盖于 Fyne 的 GLSurfaceView，实现了页面渲染和交互功能。
\

. 架构概览<\/h5>
\
text
┌─────────────────────────┐
│ Go goroutine │
│ loadURL / loadHTML / eval │
│ setBounds / setVisible / destroy │
└───────────┬─────────────┘
│
▼
┌───────────────────────────────────────┐
│ C 层任务队列 │
│ enqueue_task → dequeue_task → native_run│
└─────────────────────┬─────────────────┘
│
Handler.post on Android 主线程
▼
┌───────────────────────────────┐
│ native_run │
│ do_load_url、do_load_html…等│
└───────────────────────────────┘
``\





. 全局状态与线程安全<\/h5>
\
c
/* Global references – 跨线程持久化 /
static JavaVM *g_vm = NULL;/ Activity、WebView、WindowManager 等全局对象均保存为 GlobalRef /
static jobject g_activity = NULL;/ ，…其他全局 Ref ，…*/


/* 辅助函数 – 确保当前线程已附着到 JVM，并返回 JNIEnv /
static JNIEnv attachthread{
JNIEnv * env=NULL;*wasattached=0;ifreturn NULL;if->GetEnv& env,JNIVERSION16)==JNIOK){
return env;老实说，// 已附着
}
JavaVMAttachArgs args={JNIVERSION16。"FyneWebView",NULL};if->AttachCurrentThread& env,&args)!=JNIOK){
return NULL;其实，}
*was_attached=1;return env，} 

static void detach_thread{if->DetachCurrentThread}
``\`\








This document aggregates key knowledge from following real‑world Fyne projects:



D:\OnlineExamApp — SQLite + HTTP API + 自定义控件.

D:\FyneCa...

This HTML version is restructured to surface typical pain points developers encounter when mixing Fyne with native Android/iOS/Windows APIs.