1. 代码开发工具:为什么VNC/RFB协议源码是嵌入式与Android交叉开发的实战练兵场
你有没有试过在Android设备上实时投屏到PC,却卡在“权限申请失败”或“画面黑屏”?不是因为代码写错了,而是你根本没摸清MediaProjection生命周期和ImageReader帧回调之间的时序黑匣子。这份Android VNC服务端源码,表面看是RFB协议实现,实则是把Android底层图形采集、线程同步、Socket通信、像素格式协商这些代码开发工具链的关键断点全摊开给你看——它不教你写Hello World,而是逼你直面Surface如何被VirtualDisplay消费、RfbConnection怎么在非UI线程里安全更新FrameBuffer、InputInjector为何必须用Instrumentation而非普通KeyEvent。这不是一个能直接上线的产品,而是一套可调试、可打断点、可单步跟踪的嵌入式级代码开发沙盒:所有模块边界清晰(ScreenCapture只管取帧,VncServer只管监听,RfbConnection只管协议),所有依赖显式声明(无隐藏SDK调用),所有状态可打印(Log.d("RFB", "Handshake complete: " + clientVersion))。对刚从单片机裸机开发转过来的工程师,它比任何教程都更真实地还原了“从硬件驱动到应用协议”的全链路调试现场。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 源码结构解剖:从Android Studio工程到RFB协议栈的四层映射
2.1 工程骨架:为什么app/src/main/java是唯一可信入口
这份源码包解压后,核心就是标准Android Studio工程结构。但关键在于——所有业务逻辑严格限定在app/src/main/java下,没有jni/目录,没有混淆的aar依赖,没有build.gradle里藏匿的神秘插件。这意味着你打开项目就能立刻定位到全部可执行代码,无需猜测NDK编译产物或AAR内部实现。MainActivity.java作为唯一Activity,只做三件事:请求MEDIA_PROJECTION权限、启动ServerService前台服务、传递Intent参数。它不处理任何帧数据,不解析任何RFB消息,纯粹是系统权限的“守门人”。这种设计强迫你把关注点从“UI怎么画”转移到“权限怎么续命”——因为MediaProjection一旦被系统回收,整个屏幕采集就彻底中断,而ServerService正是通过startForeground()维持其后台存活能力。> 提示:不要在MainActivity里写onCreate()中直接调用startService(),必须等MediaProjection回调成功后再启动服务,否则ScreenCapture初始化会因缺少virtualDisplay句柄而崩溃。
2.2 屏幕采集层:ScreenCapture如何把MediaProjection变成可消费的ImageReader
ScreenCapture.java是整条链路的第一个硬骨头。它封装了MediaProjection与ImageReader的耦合关系,但绝不是简单包装。关键在于它的初始化流程:
java复制public void init(MediaProjection projection, int width, int height) {
// 1. 创建VirtualDisplay,将屏幕内容输出到Surface
virtualDisplay = projection.createVirtualDisplay(
"screen-capture",
width, height,
DisplayMetrics.DENSITY_DEVICE_STABLE,
DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,
surface, null, null
);
// 2. 创建ImageReader,从Surface读取帧数据
imageReader = ImageReader.newInstance(width, height,
PixelFormat.RGBA_8888, 2); // 缓冲区深度为2
// 3. 设置OnImageAvailableListener,在新帧到达时触发
imageReader.setOnImageAvailableListener(
reader -> {
Image image = reader.acquireLatestImage();
if (image != null) {
processImage(image); // 关键:此处才是帧处理入口
image.close();
}
},
handler // 必须指定Handler,否则回调在Binder线程
);
}
这段代码暴露了三个致命细节:第一,createVirtualDisplay()的surface参数必须来自ImageReader.getSurface(),否则VirtualDisplay无法向ImageReader投递帧;第二,ImageReader.newInstance()的缓冲区深度设为2,这是为应对acquireLatestImage()可能返回null的容错设计——当主线程处理慢于帧生成速度时,旧帧会被丢弃,只保留最新一帧;第三,setOnImageAvailableListener()必须传入Handler,否则回调发生在Binder线程,直接操作FrameBuffer会导致线程安全问题。我第一次调试时就栽在这里:没传Handler,processImage()里直接修改FrameBuffer的dirtyRects列表,结果RfbConnection线程读取到半截脏区域,画面撕裂成马赛克。
2.3 协议服务层:VncServer与RfbConnection的线程隔离模型
VncServer.java和RfbConnection.java共同构成了RFB协议的服务端骨架,但它们的职责划分极其严苛:VncServer只做一件事——在指定端口(默认5900)监听TCP连接,并为每个新连接创建独立的RfbConnection实例;RfbConnection则独占该连接的全部生命周期,从握手、像素格式协商、帧传输到输入事件注入,全部在自己的线程内完成。这种设计杜绝了跨连接状态污染。看VncServer的核心循环:
java复制public void start() {
try (ServerSocket serverSocket = new ServerSocket(port)) {
while (!isStopped) {
Socket clientSocket = serverSocket.accept(); // 阻塞等待新连接
// 为每个客户端创建独立线程
new Thread(() -> {
RfbConnection connection = new RfbConnection(clientSocket);
connection.handleConnection(); // 全部协议逻辑在此方法内
}).start();
}
} catch (IOException e) {
Log.e("VncServer", "Server socket error", e);
}
}
注意serverSocket.accept()是阻塞调用,但它被包裹在while循环中,确保服务端永不退出。而每个RfbConnection的handleConnection()方法内部,又是一个完整的RFB状态机:
java复制public void handleConnection() {
try {
handshake(); // 协议版本协商
securityHandshake(); // 安全类型选择(本源码固定为None)
clientInit(); // 获取客户端能力(如支持的编码类型)
mainLoop(); // 主循环:接收客户端请求,发送帧数据
} catch (IOException e) {
Log.w("RfbConnection", "Client disconnected", e);
}
}
这里的关键约束是:mainLoop()中所有Socket读写操作必须使用同一个DataInputStream/DataOutputStream,且不能与其他RfbConnection实例共享任何资源。我曾试图让多个连接共用一个FrameBuffer实例,结果发现RfbConnectionA正在读取第100帧时,RfbConnectionB触发了新帧捕获,直接覆盖了FrameBuffer的内存,导致A收到残缺画面。最终解决方案是——每个RfbConnection持有FrameBuffer的弱引用,但只读取,不修改;真正的帧更新永远由ScreenCapture单线程完成,通过FrameBuffer的getLatestFrame()方法获取快照。
2.4 像素与输入层:RfbPixelFormat与InputInjector的硬件抽象真相
RfbPixelFormat.java看似只是个数据结构,实则是打通Android显示子系统与RFB协议的翻译器。RFB协议要求客户端声明其支持的像素格式(bit depth、bytes per pixel、红绿蓝通道位移),而Android的ImageReader只提供RGBA_8888一种格式。RfbPixelFormat的作用就是告诉客户端:“我的服务端只支持32位RGBA,如果你的客户端不兼容,请自行转换”。它的字段定义直接对应RFB协议规范:
java复制public class RfbPixelFormat {
public final int bitsPerPixel = 32; // RFB协议字段:bits-per-pixel
public final int depth = 24; // RFB协议字段:depth
public final int bigEndianFlag = 0; // RFB协议字段:big-endian-flag
public final int trueColorFlag = 1; // RFB协议字段:true-color-flag
public final int redMax = 255; // RFB协议字段:red-max
public final int greenMax = 255; // RFB协议字段:green-max
public final int blueMax = 255; // RFB协议字段:blue-max
public final int redShift = 16; // RFB协议字段:red-shift(RGBA中R在高位)
public final int greenShift = 8; // RFB协议字段:green-shift
public final int blueShift = 0; // RFB协议字段:blue-shift
}
而InputInjector.java则揭示了Android输入事件注入的残酷现实:它必须使用Instrumentation类,且Instrumentation实例只能通过Context获取,而Context在RfbConnection线程中不可用。因此源码采用Handler跨线程传递事件:
java复制public class InputInjector {
private final Handler mainHandler;
private final Instrumentation instrumentation;
public InputInjector(Context context) {
this.mainHandler = new Handler(Looper.getMainLooper());
this.instrumentation = new Instrumentation();
// 注意:instrumentation必须在主线程初始化
}
public void injectPointerEvent(float x, float y, boolean isDown) {
mainHandler.post(() -> {
MotionEvent event = MotionEvent.obtain(
SystemClock.uptimeMillis(),
SystemClock.uptimeMillis(),
isDown ? MotionEvent.ACTION_DOWN : MotionEvent.ACTION_UP,
x, y, 0
);
instrumentation.sendPointerSync(event);
event.recycle();
});
}
}
这个设计暴露了一个血泪经验:Instrumentation.sendPointerSync()必须在主线程调用,否则抛出SecurityException。我最初把injectPointerEvent()直接放在RfbConnection的handlePointerEvent()里,结果每次触摸都崩溃。后来才明白——Instrumentation本质是系统服务代理,它需要绑定到主线程的Looper才能与InputManagerService通信。
3. 避坑指南:从权限崩溃到画面撕裂的五类高频故障
3.1 现象:MediaProjection回调未触发,MainActivity停留在权限请求页
原因:Android 10+强制要求MediaProjection必须通过startActivityForResult()启动,且onActivityResult()必须重写。但源码中MainActivity使用的是registerForActivityResult()新API(ActivityResultLauncher),若目标设备是Android 9或更低版本,此API不可用,导致回调永远不执行。
解决:降级使用传统startActivityForResult(),并在AndroidManifest.xml中声明<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />(Android 9+必需)。
3.2 现象:ScreenCapture初始化成功,但onImageAvailable()从不回调
原因:ImageReader的Surface未正确绑定到VirtualDisplay。常见错误是virtualDisplay创建时传入的surface参数不是imageReader.getSurface(),或者ImageReader.newInstance()的format参数与VirtualDisplay期望格式不匹配(如VirtualDisplay要求RGBA_8888,但ImageReader设为RGB_565)。
解决:强制统一格式为PixelFormat.RGBA_8888,并验证virtualDisplay创建后立即调用imageReader.getSurface().isValid()返回true。
3.3 现象:VNC客户端连接成功,但画面始终黑屏或闪烁
原因:FrameBuffer的dirtyRects(脏区域标记)未被正确重置。ScreenCapture.processImage()在每次新帧到来时,会计算当前帧与上一帧的差异区域并存入dirtyRects,但RfbConnection.mainLoop()发送完帧后,必须手动清空dirtyRects,否则后续帧的差异计算基于错误的“上一帧”状态。
解决:在RfbConnection.sendFramebufferUpdate()方法末尾添加frameBuffer.clearDirtyRects(),且该方法必须加synchronized锁,防止多客户端并发修改。
3.4 现象:客户端鼠标移动正常,但点击事件无响应
原因:InputInjector的instrumentation实例在RfbConnection线程中被重复创建。源码中InputInjector构造函数调用了new Instrumentation(),但Instrumentation对象必须与主线程Context绑定,跨线程创建会导致sendPointerSync()静默失败。
解决:将InputInjector改为单例,且instrumentation在Application类的onCreate()中初始化,确保其生命周期与主线程一致。
3.5 现象:多客户端连接时,后连的客户端顶掉前一个,但前一个连接未释放资源
原因:VncServer的accept()循环中,每个RfbConnection线程启动后完全自治,没有全局连接数限制或连接超时机制。当第二个客户端连接时,RfbConnectionB的handleConnection()会重新初始化ScreenCapture,导致VirtualDisplay被重建,ImageReader被关闭,RfbConnectionA失去帧源。
解决:在VncServer中维护ConcurrentHashMap<String, RfbConnection>记录活跃连接,RfbConnection构造时检查连接数,超过阈值(如1)则拒绝新连接,并在RfbConnection的finally块中自动从Map中移除自身。
4. 协议交互实战:手撕RFB握手与像素格式协商的十六进制真相
4.1 握手阶段:从TCP连接到协议版本确认的字节流解析
RFB协议的第一步是客户端与服务端交换协议版本字符串。客户端发送"RFB 003.008\n"(12字节),服务端必须原样返回"RFB 003.008\n"。但源码中的handshake()方法并非简单字符串比较,而是逐字节解析:
java复制private void handshake() throws IOException {
// 读取客户端发来的12字节协议字符串
byte[] clientVersion = new byte[12];
inputStream.readFully(clientVersion);
// 验证是否为RFB协议(前3字节必须是'R','F','B')
if (clientVersion[0] != 'R' || clientVersion[1] != 'F' || clientVersion[2] != 'B') {
throw new IOException("Invalid RFB protocol header");
}
// 解析主版本号(第4-6字节)和次版本号(第7-9字节)
String versionStr = new String(clientVersion, 0, 12).trim();
// 源码硬编码只支持3.008,其他版本直接拒绝
if (!versionStr.equals("RFB 003.008")) {
outputStream.write("RFB 003.008\n".getBytes());
outputStream.flush();
throw new IOException("Unsupported RFB version: " + versionStr);
}
// 向客户端回写确认字符串
outputStream.write("RFB 003.008\n".getBytes());
outputStream.flush();
}
这里的关键陷阱是:inputStream.readFully()会阻塞直到读满12字节,但如果客户端网络延迟,readFully()可能超时抛出SocketTimeoutException。而源码未设置socket.setSoTimeout(),导致握手无限期挂起。我在线上测试时遇到过客户端发送"RFB 003.008\n"后断网,服务端线程永远卡在readFully(),后续所有连接都被阻塞。解决方案是在VncServer创建Socket后立即设置超时:clientSocket.setSoTimeout(5000);(5秒)。
4.2 安全协商:为什么None认证是唯一可行的起点
RFB协议要求在握手后进行安全类型协商。客户端发送一个4字节整数(nSecTypes)表示支持的安全类型数量,随后发送nSecTypes个字节的安全类型ID。服务端必须从中选择一个并返回。源码中securityHandshake()方法极度简化:
java复制private void securityHandshake() throws IOException {
// 读取客户端支持的安全类型数
int nSecTypes = inputStream.readUnsignedByte();
// 读取所有安全类型ID,寻找0x01(None认证)
boolean hasNone = false;
for (int i = 0; i < nSecTypes; i++) {
int secType = inputStream.readUnsignedByte();
if (secType == 1) hasNone = true; // 0x01 = None
}
// 服务端强制选择None认证
outputStream.write(0x01); // 发送0x01表示选择None
outputStream.flush();
}
这个设计看似偷懒,实则是务实之选。RFB的None认证意味着“无需密码”,但前提是服务端运行在可信局域网。如果强行实现VNC Authentication(0x02),你需要生成16字节随机挑战(challenge)、用MD5哈希密码+挑战生成响应(response),而Android端缺乏安全的密码存储机制(SharedPreferences明文存密码极不安全)。我曾尝试集成KeyStore加密密码,结果发现KeyStore密钥生成耗时200ms以上,导致握手超时。最终放弃,接受None认证的局限性——这也解释了为什么源码文档强调“没有账号认证”。
4.3 像素格式协商:RfbPixelFormat如何影响帧数据的内存布局
当客户端发送SetPixelFormat消息(长度为20字节)时,服务端必须解析并校验。源码中clientInit()方法提取关键字段:
java复制private void setPixelFormat() throws IOException {
// 跳过消息类型字节(0x00)
inputStream.skipBytes(1);
// 读取像素格式参数(共19字节)
int bitsPerPixel = inputStream.readUnsignedByte();
int depth = inputStream.readUnsignedByte();
int bigEndianFlag = inputStream.readUnsignedByte();
int trueColorFlag = inputStream.readUnsignedByte();
// 校验:只接受32位RGBA
if (bitsPerPixel != 32 || depth != 24 || trueColorFlag != 1) {
throw new IOException("Unsupported pixel format: " +
String.format("bpp=%d, depth=%d, trueColor=%d",
bitsPerPixel, depth, trueColorFlag));
}
// 读取红绿蓝通道最大值和位移(共12字节)
int redMax = inputStream.readUnsignedShort();
int greenMax = inputStream.readUnsignedShort();
int blueMax = inputStream.readUnsignedShort();
int redShift = inputStream.readUnsignedByte();
int greenShift = inputStream.readUnsignedByte();
int blueShift = inputStream.readUnsignedByte();
// 强制校验位移:RGBA中R在byte[0],G在byte[1],B在byte[2]
if (redShift != 16 || greenShift != 8 || blueShift != 0) {
throw new IOException("Invalid RGB shift values");
}
}
这段代码揭示了RFB协议的底层真相:redShift=16意味着红色分量在32位整数中的高8位(bit 24-31),greenShift=8是中8位(bit 16-23),blueShift=0是低8位(bit 0-7)。这与Android RGBA_8888的内存布局完全一致(0xAARRGGBB)。如果客户端声称支持BGR_8888(redShift=0, blueShift=16),服务端必须拒绝,否则FrameBuffer的像素复制会把颜色通道搞反。我曾用TigerVNC客户端测试,它默认发送BGR格式,结果画面呈现诡异的青紫色——这就是redShift校验缺失的典型翻车现场。
5. 性能调优实战:从RAW帧传输到脏区域增量更新的毫秒级优化
5.1 RAW编码的致命瓶颈:为什么1080p画面每秒仅3帧
源码默认使用RFB的RawEncoding(编码类型0x00),即直接发送整帧像素数据。对于1080p(1920×1080)画面,RGBA_8888格式每帧大小为1920×1080×4=8,294,400字节(约8MB)。即使千兆局域网理论带宽125MB/s,实际TCP吞吐受Socket缓冲区、Nagle算法、ImageReader帧率限制,往往只有20-30MB/s。计算可知:8MB ÷ 25MB/s ≈ 320ms/帧,即每秒仅3帧。这远低于人眼感知流畅的30fps(33ms/帧)阈值。更糟的是,RawEncoding不压缩,网络抖动时丢包直接导致整帧丢失,画面卡顿。
5.2 脏区域增量更新:FrameBuffer如何只传输变化的像素块
FrameBuffer.java的核心价值在于dirtyRects机制。它不存储完整帧,而是维护一个List<Rect>记录自上次传输以来发生变化的矩形区域。ScreenCapture.processImage()在对比新旧帧时,只扫描dirtyRects覆盖的像素,大幅降低CPU消耗:
java复制public void updateFrame(Image image) {
// 获取新帧的ByteBuffer
ByteBuffer buffer = image.getPlanes()[0].getBuffer();
byte[] newData = new byte[buffer.remaining()];
buffer.get(newData);
// 遍历所有脏区域,只对比这些区域内的像素
for (Rect dirtyRect : dirtyRects) {
int startX = dirtyRect.left;
int startY = dirtyRect.top;
int width = dirtyRect.width();
int height = dirtyRect.height();
// 计算该区域在帧缓冲区的偏移量
int offset = (startY * widthStep + startX) * 4; // RGBA每像素4字节
// 逐像素对比,只标记真正变化的子区域
for (int y = 0; y < height; y++) {
for (int x = 0; x < width; x++) {
int idx = offset + (y * widthStep + x) * 4;
if (Math.abs(newData[idx] - oldData[idx]) > 5) { // 亮度差>5视为变化
markSubRegionAsDirty(x + startX, y + startY, 1, 1);
break;
}
}
}
}
}
这段代码的关键优化是:markSubRegionAsDirty()将大脏区域进一步切分为1×1像素块,确保RfbConnection.sendFramebufferUpdate()只传输真正变化的最小矩形。我实测1080p桌面场景(大部分区域静态),脏区域平均仅占整帧的5%-10%,传输数据量从8MB降至400KB-800KB,帧率从3fps提升至12-15fps。
5.3 网络层优化:禁用Nagle算法与调整Socket缓冲区
RfbConnection的Socket默认启用Nagle算法(合并小包以减少网络开销),但这对实时VNC是灾难——它会把多个小脏区域更新包攒成一个大包发送,导致端到端延迟飙升。必须在Socket创建后立即禁用:
java复制public RfbConnection(Socket socket) throws IOException {
this.socket = socket;
this.socket.setTcpNoDelay(true); // 关键!禁用Nagle算法
this.socket.setSendBufferSize(1024 * 1024); // 设置发送缓冲区为1MB
this.inputStream = new DataInputStream(socket.getInputStream());
this.outputStream = new DataOutputStream(socket.getOutputStream());
}
setTcpNoDelay(true)强制TCP立即发送所有数据,不等待ACK或凑够MSS(最大报文段长度)。同时setSendBufferSize(1MB)避免outputStream.write()因缓冲区满而阻塞。我曾将sendBufferSize设为默认的64KB,在1080p高动态场景下,outputStream.write()频繁阻塞,导致mainLoop()卡顿。调大后,write()几乎不阻塞,mainLoop()能稳定在15fps。
5.4 内存复用技巧:ImageReader缓冲池与ByteBuffer零拷贝
ScreenCapture中ImageReader的acquireLatestImage()每次返回新Image对象,但Image.getPlanes()[0].getBuffer()返回的ByteBuffer底层内存是复用的。源码中processImage()直接操作ByteBuffer,避免了copyPixelsToBuffer()的额外拷贝:
java复制private void processImage(Image image) {
Image.Plane plane = image.getPlanes()[0];
ByteBuffer buffer = plane.getBuffer(); // 直接获取底层缓冲区
// 计算行跨度(row stride),处理非连续内存
int rowStride = plane.getRowStride();
int pixelStride = plane.getPixelStride();
// 只复制有效像素区域,跳过padding字节
int width = image.getWidth();
int height = image.getHeight();
byte[] frameData = new byte[width * height * 4];
// 逐行复制,处理pixelStride(如RGBA中每像素4字节)
for (int y = 0; y < height; y++) {
int bufferOffset = y * rowStride;
buffer.position(bufferOffset);
buffer.get(frameData, y * width * 4, width * 4);
}
// 更新FrameBuffer
frameBuffer.updateFrame(frameData);
}
这里rowStride可能大于width*4(因内存对齐),pixelStride通常是4(RGBA)。直接buffer.get()比image.copyPixelsToBuffer()快3倍,因为后者会做额外的格式转换。我用Systrace分析发现,copyPixelsToBuffer()在1080p下耗时12ms,而buffer.get()仅4ms。
6. 从调试到交付:构建可验证的VNC服务端发布清单
6.1 四层验证法:确保每一环都经得起压力测试
要让这份VNC源码从“能跑”升级为“可靠”,必须建立分层验证体系。我把它拆解为四个不可跳过的关卡:
| 验证层级 | 测试目标 | 执行命令/方法 | 通过标准 |
|---|---|---|---|
| 系统层 | MediaProjection权限与VirtualDisplay稳定性 |
在MainActivity中连续请求/释放权限10次,观察logcat中VirtualDisplay创建日志 |
无E/MediaProjection错误,VirtualDisplay句柄不为空 |
| 采集层 | ImageReader帧率与内存泄漏 |
adb shell dumpsys meminfo com.example.vnc,运行30分钟,对比初始与结束时Pss Total |
内存增长<5MB,Image对象数量稳定在2(ImageReader缓冲区深度) |
| 协议层 | RFB握手与像素格式协商健壮性 | 使用nc命令模拟客户端:echo -ne "RFB 003.008\n" | nc 192.168.1.100 5900 |
服务端返回RFB 003.008\n,无SocketTimeoutException |
| 网络层 | 多客户端并发与断线恢复 | 启动2个TigerVNC客户端,强制杀掉其中一个,观察另一个是否持续流畅 | 被杀客户端连接释放后,剩余客户端帧率波动<10%,无黑屏 |
这个清单不是一次性的,而是每次代码变更后的回归测试基线。比如当我修改FrameBuffer的dirtyRects合并逻辑时,必须重新跑完全部四层——因为dirtyRects错误可能导致RfbConnection发送超大脏区域,瞬间打满网络带宽,触发系统层的Socket异常。
6.2 发布前必改的五个硬编码项
源码为教学目的大量使用硬编码,生产环境必须替换。我整理了最危险的五个:
- 端口号:
VncServer.java中private static final int DEFAULT_PORT = 5900;→ 改为从SharedPreferences读取,避免与系统VNC服务冲突; - 分辨率:
ScreenCapture.init()中width/height写死为1280/720→ 改为读取DisplayMetrics动态适配; - 像素格式:
RfbPixelFormat中bitsPerPixel=32→ 增加运行时检测,若设备支持RGBX_8888则降级以节省带宽; - 日志开关:所有
Log.d()→ 封装为DebugLogger类,发布版自动关闭; - 服务保活:
ServerService.startForeground()的Notification→ 替换为startForegroundService()+startForeground()双保险,适配Android 12+。
其中第5项最易被忽略。Android 12强制要求前台服务必须在startForegroundService()后5秒内调用startForeground(),否则抛出ForegroundServiceDidNotStartInTimeException。源码中ServerService.onCreate()直接调用startForeground(),在Android 12上必然崩溃。必须重构为:
java复制@Override
public void onCreate() {
super.onCreate();
// Android 12+需先调用startForegroundService()
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
startForegroundService(intent);
}
}
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
// 此处再调用startForeground()
startForeground(NOTIFICATION_ID, buildNotification());
return START_STICKY;
}
6.3 我的发布checklist:从代码提交到APK签名的七步铁律
经过二十多次VNC项目迭代,我固化了一套发布前必做的七步检查,现在每次提交代码前都会机械执行:
- 查
Log:grep -r "Log\." app/src/main/java/ | grep -v "Log\.w\|Log\.e"—— 确保所有Log.d()/Log.i()已删除或注释; - 查
TODO:grep -r "TODO\|FIXME" app/src/main/java/—— 每个TODO必须有明确负责人和截止日期,否则禁止提交; - 查
Toast:grep -r "Toast\.makeText" app/src/main/java/—— UI提示必须用Snackbar替代,Toast在后台服务中无效; - 查
Thread:grep -r "new Thread" app/src/main/java/—— 所有线程必须使用ExecutorService管理,避免Thread泄漏; - 查
Permission:aapt dump permissions app/build/outputs/apk/debug/app-debug.apk | grep "uses-permission"—— 确认AndroidManifest.xml中无冗余权限(如INTERNET已声明,ACCESS_NETWORK_STATE可删); - 查
Proguard:./gradlew assembleRelease后,用jadx-gui反编译app-release.apk,确认RfbConnection等核心类未被混淆; - 查签名:
jarsigner -verify -verbose -certs app/build/outputs/apk/release/app-release.apk | grep "sm"—— 确保所有类文件均被签名(sm标志)。
从那以后我每次发布APK前,都强制走一遍这七步。哪怕只是改一行Log,也要跑完全部检查——因为VNC服务端的崩溃不是白屏那么简单,它会导致MediaProjection权限被系统永久吊销,用户必须手动去设置里重开,这种体验伤害是不可逆的。希望帮到你。
