快速入门

创建账号

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

注册表单需要填写：

• 姓名 — 必填。
• 邮箱 — 必填，必须是有效的电子邮箱地址。
• 密码 — 必填，至少 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。页面上也提供了“返回登录？”链接。

顶部导航栏

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

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

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

查看切换后的账号时，导航栏还会在显示的姓名旁添加一个小型**“共享”**徽标，方便你随时确认正在查看谁的数据。

通知铃铛。 仅在 / 和 /apps 路由（即“我的应用”仪表盘）中显示，门户的其他页面不会显示。角标数字为所有通知分组中的通知总数。点击后会展开标题为“通知”的下拉菜单，按类型分组列出通知，每条通知都包含一段简短消息。

点击单条通知后的行为取决于通知类型：

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

此铃铛仅提供快速查看通知的下拉菜单，其界面比本指南后文介绍的独立**“我的通知”页面更简单，两者也都与“与我共享”**邀请列表相互独立。门户中确实有三个不同的邀请/通知界面；有关它们的区别，请参阅“账号”部分。

---