如何让Android Kotlin项目识别C库枚举所有项且无需重映射？

数据老陈

2026-8-19

在Android Kotlin/Java项目中访问C库枚举项的解决方案

你的C库枚举在Android端无法被Kotlin/Java识别枚举项，是因为NDK默认会把普通C枚举映射成整数类型，而非强类型枚举。要解决这个问题，可以在C代码中针对Android平台添加特定属性，让NDK工具链生成能被Kotlin/Java识别的枚举结构。

修改后的C头文件代码如下：

#if defined (__APPLE__)
#include <CoreFoundation/CFAvailability.h>

typedef CF_ENUM(uint32_t, Cases) {
  case_zero         = 0,
  case_one          = 1
};
#elif defined (__ANDROID__)
// 针对Android平台配置枚举，让NDK识别为强类型枚举
typedef enum : uint32_t __attribute__((enum_extensibility(closed))) {
  case_zero         = 0,
  case_one          = 1
} Cases;
#else
typedef enum {
  case_zero         = 0,
  case_one          = 1
} Cases;
#endif

关键说明：

enum : uint32_t：明确指定枚举的底层类型为uint32_t，和Swift端的定义保持一致，避免类型不匹配问题
__attribute__((enum_extensibility(closed)))：告诉NDK这是一个封闭枚举（所有可能的枚举值都已定义），工具链会据此生成对应的Java/Kotlin枚举类，而非仅暴露原始整数类型
修改后，Kotlin/Java代码中就能直接访问Cases.case_zero、Cases.case_one这类枚举项，不需要手动重映射