Expo项目中Android平台runtimeVersion格式问题的分析与解决

问题背景

在Expo项目的开发过程中，Android平台上出现了一个关于runtimeVersion格式的特殊问题。当开发者使用x.y格式的版本号时（例如1.130），系统会错误地截断最后一个0，导致版本号变为1.13。这个问题在iOS平台上表现正常，仅在Android平台上出现。

问题表现

具体表现为：

• x.y格式（如1.130）会被错误处理为1.13
• x.y.z格式（如1.130.0或1.130.10）则能正常显示

技术分析

经过深入分析，发现问题根源在于Android平台上的版本号处理机制。当直接在AndroidManifest.xml文件中使用<meta-data>标签设置runtimeVersion时，如果采用原始值而非字符串资源引用，系统会对版本号进行特殊处理，导致格式异常。

解决方案

正确的做法是使用字符串资源引用的方式设置runtimeVersion：

1. 在AndroidManifest.xml中使用：

<meta-data 
  android:name="expo.modules.updates.EXPO_RUNTIME_VERSION" 
  android:value="@string/expo_runtime_version"/>

2. 在strings.xml资源文件中定义实际版本号：

<string name="expo_runtime_version">1.130</string>

最佳实践

对于Expo项目，建议开发者：

1. 始终使用eas update:configure命令进行配置
2. 避免直接在manifest中硬编码版本号
3. 采用字符串资源引用的方式设置runtimeVersion
4. 对于自定义部署场景，确保遵循相同的资源引用模式

总结

这个案例展示了Android平台上版本号处理的特殊性，也提醒开发者在跨平台开发中需要注意平台差异。通过使用标准的资源引用方式，可以避免类似问题的发生，确保版本号在各个平台上表现一致。

对于从Expo云服务迁移到自托管服务的开发者，特别需要注意配置方式的正确性，确保所有配置项都按照平台最佳实践进行设置。