星端 IDE星空团队 下载 App

上手文档

十分钟跑通第一个 APK

这一页按顺序讲:装好、建项目、写代码、点编译、装到手机。卡住的话先翻最后一节「常见问题」。

1. 安装

  1. 拿到安装包(群里或作者给的链接),用文件管理器点开。
  2. 系统提示「未知来源」,允许一次即可。
  3. 首次打开会申请存储权限,用于读写项目和编译产物,必须给。
  4. 登录账号。登录后头像、积分、云服务都在「更多」页里。
首次编译如果提示缺工具链,按弹窗指引安装「完整编译工具链」,装完就常驻本机,之后不用再下。

2. 新建项目

  1. 首页点「+ 新建项目」。
  2. 选类型:中文编程(最省事)、Java、Kotlin。
  3. 填应用名、包名(例如 com.xingkong.hello)、版本号。
  4. 创建完会生成标准工程结构:main/java、main/res、AndroidManifest.xml。

3. 中文编程基础

一个 .xd 文件就是一个窗口。缩进表示层级,冒号后面跟逻辑块。

窗口 "计数器" 组件 数字 : 文本 内容 = "0" 字号 = 28 组件 加一 : 按钮 内容 = "点一下" 点击 : 数字.内容 = "点了 " + 次数 次数 = 次数 + 1

几条规则:

4. 编译与打包

  1. 编辑器顶部点「编译」。
  2. 工具链在你手机上依次跑资源编译、源码编译、dex、签名。进度和日志在下方面板。
  3. 成功后会给出 APK 路径,可以直接点「安装」。
  4. 要发布就用自己的 keystore 签名:在项目设置里填 keystore 路径和密码。
编译全程在本机,不上传服务器。断网也能编,除非项目第一次要拉依赖。

5. 出错怎么办

编译器会把报错指到原文那一行,并在编辑器里标红。常见几类:

实在看不懂日志,把报错发给 AI 开发 Agent,它会自己读工程修。

6. 用 AI 帮你写

  1. 进 AI 页,新建对话,选「开发软件 Agent」。
  2. 直接说需求,例如「给项目加一个登录页,账号密码存本地,登录成功跳主页」。
  3. 它会列文件、改代码、编译、按报错继续修。中途可以点停止。
  4. 改坏了想退回:让它回滚,或者自己去 .xdide_history 找备份。

7. 连接服务器(可选)

要做后端、挂网站才需要。

  1. 「更多」→「服务器市场」,选澳洲机房套餐,支付宝或微信付款。
  2. 开通后在「我的云服务器」里看 IP、账号、密码。
  3. AI 页或终端里直接 SSH 连上去,装环境、传文件、跑服务都行。

8. 常见问题

点编译没反应 / 一直转圈

先看日志面板有没有输出。没输出多半是工具链没装完,去设置里检查「编译工具链」状态,缺哪个装哪个。

编译很慢

第一次编译要建缓存,慢是正常的;后面增量编译会快很多。手机剩余空间太少也会拖慢,建议留 2GB 以上。

装不上 / 解析包出错

同包名的旧版本签名不一样,先卸载旧的;或者安装包没下载完整,重新拿一次。

AI 说我没登录

退出账号重新登录一次,让会话票据刷新。仍然不行就在「更多」页把 App 数据清一下再登。

工程能不能搬到电脑上

能。工程就是标准 Gradle 结构,整个目录拷到电脑用 Android Studio 打开即可。