中文网
🌐 Nodejs.cn
首页指南EAS参考学习

This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

Expo AgeRange

一个库，通过 Android 上的 Play Age Signals API 和 iOS 上的 Declared Age Range 框架提供年龄范围信息访问。

Android
iOS
Included in Expo Go

重要 此库目前处于alpha阶段，并且会经常发生重大更改。

expo-age-range 提供用户年龄范围信息的访问权限。它在 Android 上使用 Google 的 Play Age Signals API，在 iOS 上使用 Apple 的 Declared Age Range framework。

这个库允许你从应用用户那里请求年龄范围信息，以帮助你遵守适龄内容规定（例如在美国德克萨斯州）并在你的应用中提供适合年龄的体验。

🌐 This library allows you to request age range information from your app users to help you comply with age-appropriate content regulations (such as in Texas, USA) and provide age-appropriate experiences in your app.

局限性

🌐 Limitations

我们强烈建议在真实设备上测试功能，因为模拟器运行时可能无法按预期工作。

🌐 We strongly recommend testing the functionality on a real device, as simulator runtimes may not work as expected.

安装

🌐 Installation

Terminal
- npx expo install expo-age-range

If you are installing this in an existing React Native app, make sure to install expo in your project.

应用配置中的配置

🌐 Configuration in app config

设置 iOS 项目

🌐 Setup iOS project

要在 iOS 上使用年龄范围 API，你需要使用 Xcode 26.0 或更高版本构建项目。需要 com.apple.developer.declared-age-range 权限。将其添加到你的 应用配置 文件中：

🌐 To use the age range API on iOS, you need to build your project with Xcode 26.0 or later. The com.apple.developer.declared-age-range entitlement is required. Add it to your app config file:

app.json
{
  "expo": {
    "ios": {
      "entitlements": {
        "com.apple.developer.declared-age-range": true
      }
    }
  }
}
Are you using this library in an existing React Native app?

对于现有的 React Native 项目，将权限添加到项目的 ios/[app]/[app].entitlements 文件中：

🌐 For existing React Native projects, add the entitlement to your project's ios/[app]/[app].entitlements file:

<key>com.apple.developer.declared-age-range</key>
<true/>

用法

🌐 Usage

Age Range Usage
import * as AgeRange from 'expo-age-range';
import { useState } from 'react';
import { StyleSheet, Text, View, Button } from 'react-native';

export default function App() {
  const [result, setResult] = useState<AgeRange.AgeRangeResponse | { error: string } | null>(null);

  const requestAgeRange = async () => {
    try {
      const ageRange = await AgeRange.requestAgeRangeAsync({
        threshold1: 10,
        threshold2: 13,
        threshold3: 18,
      });
      setResult(ageRange);
    } catch (error) {
      setResult({ error: error.message });
    }
  };

  return (
    <View style={styles.container}>
      <Button title="请求年龄范围" onPress={requestAgeRange} />
      {result && (
        <Text style={styles.result}>
          {'error' in result ? `Error: ${result.error}` : `Lower age bound: ${result.lowerBound}`}
        </Text>
      )}
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    padding: 20,
  },
  result: {
    marginTop: 20,
    fontSize: 16,
  },
});

其他资源

🌐 Additional resources

应用接口

🌐 API

import * as AgeRange from 'expo-age-range';

Methods

AgeRange.getRequiredRegulatoryFeaturesAsync()

Only for: 
iOS 26.4+

Returns the set of regulatory features that the OS reports as required for the current user.

Use this to discover which age-assurance obligations apply.

Resolves with null on iOS earlier than 26.4 and on Android and web — treat null as "unknown" rather than "no features required".

Returns:
Promise<AgeRangeRegulatoryFeature[] | null>

AgeRange.isEligibleForAgeFeaturesAsync()

Only for: 
iOS 26.2+

Asks the OS whether age-assurance regulation applies to the current user. Apple uses this to signal that the account region is covered by a law such as Utah's or Louisiana's age-assurance requirements, so apps can avoid gating users in jurisdictions where the rules do not apply.

  • Resolves with true only when Apple confirms regulation applies.
  • Resolves with false when the OS confirms regulation does not apply.
  • Resolves with null on iOS earlier than 26.2, and on Android and web. Treat null as "unknown" rather than a definitive false.
  • Rejects when the request fails — see AgeRangeService.Error for more information. Treat rejection as "unknown" and fall through to requestAgeRangeAsync or your own gating logic.

Recommended pattern: call this first and only prompt the user for their age range when the result is not false. When it is false, the user is outside a regulated jurisdiction and you can skip the age gate entirely.

Returns:
Promise<boolean | null>

Example

try {
  const eligible = await isEligibleForAgeFeaturesAsync();
  if (eligible === false) {
    // Regulation does not apply — no age gate needed.
    return;
  }
} catch {
  // Treat errors as "unknown" and fall through to the prompt below or your own gating logic.
}

const ageRange = await requestAgeRangeAsync({ threshold1: 18 });

AgeRange.requestAgeRangeAsync(options)

Only for: 
Android
iOS 26.0+

ParameterType
optionsAgeRangeRequest

Prompts the user to share their age range with the app. Responses may be cached by the OS for future requests.

Returns:
Promise<AgeRangeResponse>

A promise that resolves with user's age range response, or rejects with an error. The user needs to be signed in on the device to get a valid response. When not supported (earlier than iOS 26 and web), the call returns lowerBound: 18, which is equivalent to the response of an adult user.

AgeRange.showSignificantUpdateAcknowledgmentAsync(updateDescription)

Only for: 
iOS 26.4+

ParameterTypeDescription
updateDescriptionstring

A description of the significant update to show to the user.


Displays a system-provided interface for people to acknowledge a significant app update.

Only on iOS 26.4+, this presents an update acknowledgement dialog and resolves once the user confirms it, or rejects with an error. On unsupported platforms this resolves immediately without showing any UI.

Call getRequiredRegulatoryFeaturesAsync first to determine whether the user actually needs to acknowledge a significant change — only invoke this function when the returned features include 'significantAppChangeRequiresAdultNotification'. Doing so avoids prompting users who are not subject to the regulation.

Returns:
Promise<void>

Types

AgeRangeRegulatoryFeature

Only for: 
iOS 26.4+

Literal Type: string

A regulatory feature that your app may need to support for the current user.

Mirrors AgeRangeService.RegulatoryFeature.

Acceptable values are: 'declaredAgeRangeRequired' | 'significantAppChangeRequiresAdultNotification' | 'significantAppChangeRequiresParentalConsent'

AgeRangeRequest

Only for: 
iOS

Options for requesting age range information from the user.

PropertyTypeDescription
threshold1number

The required minimum age for your app.

threshold2(optional)number

An optional additional minimum age for your app.

threshold3(optional)number

An optional additional minimum age for your app.

AgeRangeResponse

Response containing the user's age range information.

Contains age boundaries and platform-specific metadata.

PropertyTypeDescription
activeParentalControls(optional)string[]
Only for: 
iOS

List of parental controls enabled and shared as a part of age range declaration.

ageRangeDeclaration(optional)'selfDeclared' | 'guardianDeclared' | null
Only for: 
iOS

Indicates whether the age range was declared by the user themselves or someone else (parent, guardian, or Family Organizer in a Family Sharing group).

installId(optional)string | null
Only for: 
Android

An ID assigned to supervised user installs by Google Play, used to notify you of revoked app approval.

lowerBoundnumber | null

The lower limit of the person’s age range.

mostRecentApprovalDate(optional)number | null
Only for: 
Android

The effective date (timestamp) of the most recent significant change that was approved.

upperBoundnumber | null

The upper limit of the person’s age range.

userStatus(optional)'VERIFIED' | 'SUPERVISED' | 'SUPERVISED_APPROVAL_PENDING' | 'SUPERVISED_APPROVAL_DENIED' | 'DECLARED' | 'UNKNOWN' | null
Only for: 
Android

The user's age verification or supervision status.

错误代码

🌐 Error codes

可在本地模块抛出的任何错误的 code 属性中获取。有关 Android 特定的错误代码，请参见 使用 Play Age Signals API 文档 中的“处理 API 错误代码”。

🌐 Available in the code property of any error thrown by the native module. For Android-specific error codes, see "Handle API error codes" in Use Play Age Signals API docs.

代码平台描述
ERR_AGE_RANGE_USER_DECLINED
iOS
用户拒绝分享他们的年龄范围。
ERR_AGE_RANGE_NOT_AVAILABLE
iOS
年龄范围不可用。最可能的原因是用户未在设备上登录他们的 Apple 账户。
ERR_AGE_RANGE_INVALID_REQUEST
iOS
提供的参数无效。年龄范围必须至少相隔 2 年。