上手文档
十分钟跑通第一个 APK
这一页按顺序讲:装好、建项目、写代码、点编译、装到手机。卡住的话先翻最后一节「常见问题」。
1. 安装
- 拿到安装包(群里或作者给的链接),用文件管理器点开。
- 系统提示「未知来源」,允许一次即可。
- 首次打开会申请存储权限,用于读写项目和编译产物,必须给。
- 登录账号。登录后头像、积分、云服务都在「更多」页里。
首次编译如果提示缺工具链,按弹窗指引安装「完整编译工具链」,装完就常驻本机,之后不用再下。
2. 新建项目
- 首页点「+ 新建项目」。
- 选类型:中文编程(最省事)、Java、Kotlin。
- 填应用名、包名(例如
com.xingkong.hello)、版本号。 - 创建完会生成标准工程结构:
main/java、main/res、AndroidManifest.xml。
3. 中文编程基础
一个 .xd 文件就是一个窗口。缩进表示层级,冒号后面跟逻辑块。
窗口 "计数器"
组件 数字 : 文本
内容 = "0"
字号 = 28
组件 加一 : 按钮
内容 = "点一下"
点击 :
数字.内容 = "点了 " + 次数
次数 = 次数 + 1
几条规则:
- 字符串用英文双引号或中文引号都行,注释用
#或//。 - 颜色可以写「红」「浅蓝」「#FF5533」,字号写数字。
- 组件的可见性写
可见 = 假就能隐藏。 - 列表用「添加项」「清空项」操作,改完界面自动刷新。
4. 编译与打包
- 编辑器顶部点「编译」。
- 工具链在你手机上依次跑资源编译、源码编译、dex、签名。进度和日志在下方面板。
- 成功后会给出 APK 路径,可以直接点「安装」。
- 要发布就用自己的 keystore 签名:在项目设置里填 keystore 路径和密码。
编译全程在本机,不上传服务器。断网也能编,除非项目第一次要拉依赖。
5. 出错怎么办
编译器会把报错指到原文那一行,并在编辑器里标红。常见几类:
- 语法错误:缩进层级不对、冒号漏了、括号没闭合。看它给出的行号和原句。
- 资源缺失:引用了不存在的图片或颜色。检查
res目录下的文件名。 - 依赖下载失败:换成镜像源,或先连网再编一次。
- 签名冲突:手机上已装过同包名但签名不同的版本,先卸载再装。
实在看不懂日志,把报错发给 AI 开发 Agent,它会自己读工程修。
6. 用 AI 帮你写
- 进 AI 页,新建对话,选「开发软件 Agent」。
- 直接说需求,例如「给项目加一个登录页,账号密码存本地,登录成功跳主页」。
- 它会列文件、改代码、编译、按报错继续修。中途可以点停止。
- 改坏了想退回:让它回滚,或者自己去
.xdide_history找备份。
7. 连接服务器(可选)
要做后端、挂网站才需要。
- 「更多」→「服务器市场」,选澳洲机房套餐,支付宝或微信付款。
- 开通后在「我的云服务器」里看 IP、账号、密码。
- AI 页或终端里直接 SSH 连上去,装环境、传文件、跑服务都行。
8. 常见问题
点编译没反应 / 一直转圈
先看日志面板有没有输出。没输出多半是工具链没装完,去设置里检查「编译工具链」状态,缺哪个装哪个。
编译很慢
第一次编译要建缓存,慢是正常的;后面增量编译会快很多。手机剩余空间太少也会拖慢,建议留 2GB 以上。
装不上 / 解析包出错
同包名的旧版本签名不一样,先卸载旧的;或者安装包没下载完整,重新拿一次。
AI 说我没登录
退出账号重新登录一次,让会话票据刷新。仍然不行就在「更多」页把 App 数据清一下再登。
工程能不能搬到电脑上
能。工程就是标准 Gradle 结构,整个目录拷到电脑用 Android Studio 打开即可。