WordPress-Android项目中自托管站点添加功能的问题分析与修复

在WordPress-Android移动应用开发过程中，开发团队发现了一个影响用户体验的重要缺陷——自托管站点添加功能无法正常工作。这个问题主要出现在应用的25.6.1版本中，而在之前的25.6版本中则表现正常。

问题现象

当用户尝试通过Jetpack应用的"添加站点"功能选择"添加自托管站点"时，会出现两种不同的异常情况：

1. 对于全新的WordPress.com账户（尚未添加任何站点的账户），系统会显示错误提示："无法选择新添加的自托管站点"。

2. 对于已经拥有至少一个站点的WordPress.com账户，系统会错误地将用户引导至已连接站点的"带我参观"界面，而不是预期的自托管站点添加流程。

技术背景

自托管站点是指用户在自己服务器上安装的WordPress实例，与直接使用WordPress.com提供的托管服务不同。在移动应用中集成这类站点的管理功能需要特殊的认证流程。从25.6版本开始，应用引入了基于网页的登录机制，但实际实现是在25.6.1版本中完成的。

问题根源

经过代码审查和版本对比，开发团队确认这个缺陷是在25.6.1版本中引入的。虽然25.6版本的发布说明提到了网页登录功能，但实际代码变更是在后续的小版本更新中完成的。这种版本说明与实际实现的不一致导致了问题的出现。

解决方案

开发团队通过代码提交#21695修复了这个问题。修复工作主要涉及以下几个方面：

1. 修正了自托管站点添加流程的导航逻辑，确保用户能够正确进入添加流程。

2. 修复了全新账户情况下的错误处理机制，提供更有意义的错误反馈。

3. 统一了不同账户状态下的用户体验，确保行为一致性。

经验总结

这个案例提醒开发团队在版本管理和功能发布方面需要注意：

1. 发布说明应与实际代码变更严格对应，避免误导。

2. 新功能的引入需要更全面的测试覆盖，特别是边缘用例（如全新账户）。

3. 导航流程的修改需要特别注意状态管理和上下文传递。

对于移动应用开发者而言，这个案例也展示了如何处理认证流程中的状态管理问题，以及如何确保不同用户场景下的一致体验。