上次给社团做签到应用,需要在活动现场实时生成一个二维码,让到场的人扫一下就能完成签到。AppInventor2本身没有现成的二维码组件,我在社区里翻了一圈,最后选定QRCodeGenerator这个拓展——根据给定文本生成二维码,编译apk也不报错。整个用下来确实省心,但中间也踩过几个和"打包"相关的坑。这篇就把完整过程写出来:拓展从哪里拿、怎么导入、块逻辑怎么搭,以及为什么有些项目一模一样的写法,别人编译顺利,到你这里就卡住。
适合正在做AI2项目、需要在应用里动态生成二维码的开发者,尤其适合被"AI伴侣里一切正常,一编译APK就报错"折磨过的朋友。
1. 为什么"生成二维码"在AppInventor2里这么绕
AppInventor2本身不提供生成二维码的组件,这算是平台的先天限制。做这类功能通常有三条路:调用在线API、用WebView里塞JavaScript、或者用拓展。
调用在线API最省事,但问题也最明显。二维码内容要发给第三方服务器,应用一断网就变成白屏;在线接口通常有每分钟调用次数限制,签到场景几十个人同时操作的时候,很容易触发限流。WebView里跑JavaScript是另一条路,要自己维护一套HTML模板,还要处理AI2和JS之间的数据传递,写起来绕,调试起来更绕。拓展方案把编码逻辑全部放在本地执行,不依赖网络,没有调用次数限制,只需要关心"传文本进去、拿图片出来",这个思路明显更干净。
QRCodeGenerator拓展的底层核心是ZXing库,也就是Zebra Crossing——业界非常成熟的条码图像处理库。二维码的生成原理不复杂:把一段文本按照QR码的编码规则拆分成数据段,加入纠错码,再按矩阵排列成黑白方块。ZXing把这一整套逻辑封装好了,拓展作者再把ZXing打包进Android拓展里,暴露成AI2能调用的方法。
这里有个关键点需要提前理解:AI2拓展不是随便把Java类扔进去就能用的,它对API访问权限有白名单限制,很多Java类在拓展里根本调不了。二维码生成涉及图形处理,恰恰需要用到一些不在白名单里的类,所以拓展必须把需要的ZXing核心类整个打包进.aix文件里,而不是依赖外部环境。这正是很多拓展"编译APK时出问题"的根源,后面会详细说。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 拓展的获取、导入与版本鉴别
QRCodeGenerator拓展并不是AI2官方内置的组件,需要自己下载.aix文件再导入。获取渠道主要是MIT App Inventor的官方拓展库和社区论坛,搜一下就能找到。
下载的时候要留个心眼,别看到"QRCode"就点。社区的拓展分好几个版本,有些是老作者维护的历史版,有些是后来人改的维护版,还有的人会拿不同ZXing版本重新编译。我的建议是优先选更新时间最近的版本,因为新版会适配当前的构建服务器,报错概率低得多。如果你拿到一个拓展没有文档而且下载时间是三年前的,建议直接
