Apps Kit SDK logoApps Kit SDK
文档 · Apps Kit SDK 门户

快速入门

创建账号

新用户可通过 /register 注册。页面分为左右两部分:左侧是产品宣传面板,包含带动画效果的“欢迎使用 Apps Kit SDK”标题、一行产品介绍,以及三张动态统计卡片——更高收益、匹配率、崩溃与 ANR。这些只是用于展示的宣传文案,并非你的账号数据。右侧是注册表单。

1782301701768-REGISTER_SCREEN_IMAGE.png

注册表单包含以下字段:

  • 姓名 — 必填。
  • 电子邮箱 — 必填,必须是有效的电子邮箱地址。
  • 密码 — 必填,至少 8 个字符,且必须包含至少一个大写字母、一个小写字母和一个特殊字符(例如 !@#$%^&*)。

点击创建账号后,系统会创建一个 Firebase 邮箱/密码账号,立即通过 Firebase 发送邮箱验证邮件,然后在 Apps Kit SDK 后端注册该用户(调用 POST /oauth/login,并传入 oauthProvider: "email")。完成后,你会被重定向到 /login。注册不会自动登录,且必须先完成邮箱验证才能登录(参见下方的“登录”)。

你也可以选择使用 Google 注册,通过 Firebase Google 弹出窗口(signInWithPopup)完成注册,并使用 oauthProvider: "gmail" 注册账号。使用 Google 注册无需单独验证邮箱,完成后会根据账号类型直接进入 /(我的应用)或 /users。

点击**“已有账号?在此登录”**链接可返回 /login。

登录

登录页面(/login)采用与注册页面相同的双面板布局:左侧为产品宣传面板,右侧为登录卡片。

LOGIN_SCREEN_IMAGE

登录表单包含:

  • 电子邮箱 — 必填,须符合有效的邮箱格式。
  • 密码 — 必填。
  • 密码字段中的显示/隐藏切换按钮(眼睛图标)。
  • 继续 — 提交按钮,表单通过验证后才会启用。
  • 记住我 — 勾选后,会将你的邮箱地址(不保存密码)保存到浏览器,以便下次访问时自动填入。
  • 忘记密码? — 链接到 /forget-password。
  • **“使用 Google 登录”**按钮 — 采用与 Google 注册相同的 Firebase 弹出窗口流程,但用于登录已有账号。
  • “新用户?在此注册” — 链接到 /register。

使用邮箱/密码登录时,系统还会检查你的 Firebase 账号是否已完成邮箱验证。如果未验证,页面会提示“请先验证邮箱。”,并且不会登录。无论使用哪种方式,登录成功后,普通用户账号会进入 /(我的应用),内部账号或管理员账号则会进入 /users。

忘记密码

/forget-password 页面只有一个字段,用于输入邮箱地址。提交后,系统会调用 Firebase 的 sendPasswordResetEmail。门户内不提供密码重置流程;你会收到包含重置链接的邮件,同时页面会显示 Toast 提示:“密码重置邮件已发送,请检查收件箱。”随后返回 /login。页面上也提供了“返回登录?”链接。

1782301803832-FORGOT_PASSWORD_IMAGE.png

顶部导航栏

登录后,除身份验证相关页面外,每个页面都会显示顶部导航栏,右侧为账号菜单。仅在“我的应用”页面,账号菜单旁还会显示通知铃铛。

账号菜单。 点击右上角的头像、姓名或邮箱,会展开下拉菜单,其中包含:

  • **“我的账号”**条目,代表你自己的账号(选中时会显示一个蓝点,表示当前正在使用该账号上下文)。
  • **“与我共享”*区域 — 仅当你已接受至少一个来自其他团队的共享邀请时才会显示。该区域会列出每位邀请人的姓名、邮箱和头像。点击其中一位邀请人,会将整个门户的账号上下文切换到对方账号(技术上是分发 switchAccount() 操作)。此后你看到的所有内容,包括“我的应用”“品牌”“广告活动”等,都会显示对方*的资源,并根据对方授予你的权限进行筛选。
  • 底部区域会随当前账号上下文变化:查看自己的账号时,显示**“个人资料”链接;查看已切换到的共享账号时,则显示红色的“退出 → 与我共享”**按钮。点击该按钮会切回你自己的账号,并跳转到“与我共享”页面。

查看切换后的账号时,导航栏还会在显示的名称旁添加一个小型**“共享”**标记,让你随时知道当前查看的是谁的数据。

1782301838331-NAVBAR_ACCOUNT_DROPDOWN_IMAGE.png

通知铃铛。 仅在 / 和 /apps 路由(即“我的应用”控制台)上显示,门户的其他页面不会显示。角标数字表示所有通知分组中的通知总数。点击铃铛会展开标题为“通知”的下拉菜单,按类型分组列出通知,每条通知都附有简短消息。

点击单条通知时,具体行为取决于通知类型:

  • 如果通知类型为 upatedSdkVersion(“SDK 版本已更新”提醒),点击后会直接进入该应用的“应用详情”页面(/app/:id),且不会将通知标记为已读。
  • 对于其他所有通知类型,点击后会跳转到“下载 SDK”页面,并将其标记为已读(调用标记已读接口,并显示“通知已成功标记为已读”的 Toast 提示)。

1782301875830-NAVBAR_NOTIFICATIONS_DROPDOWN_IMAGE.png

此铃铛仅提供用于快速浏览的下拉菜单,其界面比本指南后续介绍的独立**“我的通知”页面更简单,两者并非同一界面;它们也都不同于“与我共享”**邀请列表。门户中确实存在三种不同的邀请/通知界面,具体区别请参阅“账号”部分。