Expo大作战(四十)--expo sdk api之 Calendar,Constants

简要：本系列文章讲会对expo进行全面的介绍，本人从2017年6月份接触expo以来，对expo的研究断断续续，一路走来将近10个月，废话不多说，接下来你看到内容，讲全部来与官网

我猜去全部机翻+个人修改补充+demo测试的形式，对expo进行一次大补血！欢迎加入expo兴趣学习交流群：597732981

【之前我写过一些列关于expo和rn入门配置的东i西，大家可以点击这里查看：从零学习rn开发】

相关文章：

Expo大作战(一)--什么是expo，如何安装expo clinet和xde，xde如何使用

Expo大作战(二)--expo的生命周期，expo社区交流方式，expo学习必备资源，开发使用expo时关注的一些问题

Expo大作战(三)--针对已经开发过react native项目开发人员有针对性的介绍了expo，expo的局限性，开发时项目选型注意点等

Expo大作战(四)--快速用expo构建一个app，expo中的关键术语

Expo大作战(五)--expo中app.json 文件的配置信息

Expo大作战(六)--expo开发模式，expo中exp命令行工具，expo中如何查看日志log，expo中的调试方式

Expo大作战(七)--expo如何使用Genymotion模拟器

Expo大作战(八)--expo中的publish以及expo中的link，对link这块东西没有详细看，大家可以来和我交流

更多>>

写在二十三章以后的话，之前的翻译，不管如何，好与不好，终究是告一段落，也把expo基础理论的东西又深入的理解了一遍，后续expo大作战系列将主要介绍expo sdk的api。

---

常量(Constants)

系统信息在应用的整个生命周期中保持不变。

Expo.Constants.appOwnership
Returns expo, standalone, or guest.。如果是expo，这个体验就在expo客户端内部运行。如果是standalone，它是一个standalone app.。如果是guest，它已通过独立应用程序的链接打开。

Expo.Constants.expoVersion
当前正在运行的Expo客户端的版本字符串。

Expo.Constants.deviceId
expo客户端的特定设备和安装唯一的标识符。

Expo.Constants.deviceName
设备类型的人类可读名称。

Expo.Constants.deviceYearClass
此设备的设备年份类别。

Expo.Constants.getWebViewUserAgentAsync（）
获取将包含在此设备上运行的Web视图发送的请求中的用户代理字符串。这可能与您在JS提取请求中提供的用户代理可能不同。

Expo.Constants.isDevice
如果应用程序在设备上运行，则为true;如果在模拟器或仿真器中运行，则为false。

Expo.Constants.platform

IOS

• buildNumber

此应用程序中CFBundleVersion的嵌入Info.plist值中指定的内部版本号。在独立应用程序中，您可以使用app.json中的ios.buildNumber值进行设置。这可能与Expo.Constants.manifest.ios.buildNumber中的值不同，因为清单可以在空中更新(热更新)，而对于给定的本机二进制文件，此值永远不会更改。

• platform

该设备的Apple内部模型标识符，例如iPhone1,1。

• model

该设备的人可读模型名称，例如iPhone 7 Plus。

• userInterfaceIdiom

此设备的用户界面习惯用法，即应用程序是在iPhone还是iPad上运行。目前支持的值是手机和平板电脑。 Apple TV和CarPlay将显示为不受支持。

• systemVersion

在此设备上运行的iOS版本，例如10.3。

Android

• versionCode

app.json中由android.versionCode设置的版本代码。

• Expo.Constants.sessionId

一个字符串，对于当前应用程序会话是唯一的。它在应用程序之间以及同一应用程序的多次启动中有所不同。

• Expo.Constants.statusBarHeight

设备的默认状态栏高度。在使用位置跟踪或打电话时，不考虑更改。

• Expo.Constants.systemFonts

当前设备上可用的系统字体名称列表。

• Expo.Constants.manifest

该应用的清单对象。

• Expo.Constants.linkingUri

由于深层链接而打开应用程序时，URI的前缀不包含深层链接部分。该值取决于Expo.Constants.appOwnership：如果您的应用程序在expo客户端中独立运行，则可能会有所不同。

日历(Calendar)

提供一个用于与设备的系统日历，事件，提醒和相关记录交互的API。

查看此页面的底部，获取此API中使用的对象的所有可能字段的完整列表。

Expo.Calendar.getCalendarsAsync（EntityType）
获取一组日历对象，其中包含有关设备上存储的不同日历的详细信息。

参数
entityType（string） - （仅iOS）非必须填写字段，但如果定义，则将返回的日历过滤为特定的实体类型。可能的值是Expo.Calendar.EntityTypes.EVENT（适用于Calendar应用程序中显示的日历）和Expo.Calendar.EntityTypes.REMINDER（适用于提醒应用程序）。

返回
与所提供的实体类型匹配的日历对象数组（如果提供）。

Expo.Calendar.createCalendarAsync（details）
在设备上创建一个新日历，允许事件稍后添加并显示。

参数
details（object） -

要创建日历的详细信息地图（请参阅下面有关这些字段的说明）：

• title（string） - 必需
• color（string） - 必需
• entityType（string） - 必需（仅iOS）
• sourceId（string） - 必需（仅iOS）。要用于日历的源的ID。可能与任何其他本地存储日历的来源相同。
• source（object） - 必需（仅限Android）。表示要用于日历的源的对象。
  • 　　isLocalAccount（boolean） - 此源是否是本地电话帐户。如果type未定义，则必须为true。
  • 　　name（string） - 必需。拥有此日历并用于将日历同步到设备的帐户的名称。
  • 　　type（string） - 拥有此日历并用于将其同步到设备的帐户的类型。如果isLocalAccount是虚假的，那么必须定义它，并且必须与设备上的帐户一起匹配名称，否则操作系统将删除日历。
• name（string） - 必需（仅限Android）
• ownerAccount（string） - 必需（仅限Android）
• timeZone（string） - （仅限Android）
• allowedAvailabilities（array） - （仅限Android）
• allowedReminders（array） - （仅限Android）
• allowedAttendeeTypes（array） - （仅限Android）
• isVisible（boolean） - （仅限Android）
• isSynced（boolean） - （仅限Android）
• accessLevel（string） - （仅限Android）

返回
代表新创建的日历的ID的字符串。

Expo.Calendar.updateCalendarAsync（id，details）
更新设备上存储的现有日历的详细信息。要删除一个属性，明确地将其设置为null。

参数
id（string） - 要更新的日历的ID。需要。

details（object） -

要更新的属性的地图（请参阅下面的这些字段的说明）：

• title (string)（字符串）
• sourceId（string） - （仅iOS）
• color（string） - （仅iOS）
• name（string） - （仅限Android）
• isVisible（boolean） - （仅限Android）
• isSynced（boolean） - （仅限Android）

Expo.Calendar.deleteCalendarAsync（ID）
从设备中删除现有的日历和所有关联的事件/提醒/与会者(events/reminders/attendees)。谨慎使用(Use with caution.)。

参数
id（string） - 要删除的日历的ID。

Expo.Calendar.getEventsAsync（calendarIds，startDate，endDate）
返回指定时间段内给定日历集中的所有事件。

参数
calendarIds（array） - 要搜索事件的日历的ID的数组。必需。

startDate（Date） - 搜索中的事件的时间段开始。必需。

endDate（Date） - 搜索中的事件的时间段结束。必需。

返回
与搜索条件匹配的Event对象数组。

Expo.Calendar.getEventAsync（id，recurringEventOptions）
返回由ID选择的特定事件。如果需要定期事件的特定实例，则还必须提供此实例的开始日期，因为定期事件的实例在iOS或Android上没有自己的唯一且稳定的ID。

参数
id（string） - 要返回的事件的ID。需要。

recurringEventOptions（object） -

重复性事件的选项图：

• instanceStartDate（Date） - 如果查找循环事件的单个实例，则表示所需实例的开始时间的Date对象。如果没有提供，并且id表示重复事件，则默认情况下会返回该事件的第一个实例。

返回
与提供的条件匹配的Event对象（如果存在）。

Expo.Calendar.createEventAsync（calendarId，details）
在指定日历上创建新事件。

参数
calendarId（字符串） - 要在其中创建此事件的日历的ID。必需。

details（details） -

要创建的事件的详细信息图（有关这些字段的说明，请参阅下面的内容）：

• title（string）
• startDate（Date） - 必需。
• endDate（Date） - Android上需要。
• allDay（boolean）
• location （string）
• notes （string）
• alarms （Array）
• recurrenceRule（RecurrenceRule）
• availability (string)
• ttimeZone (string) - Android上必需的。
• endTimeZone（string） - （仅限Android）
• url（string） - （仅iOS）
• organizerEmail（string） - （仅限Android）
• accessLevel（string） - （仅限Android）
• guestsCanModify（boolean） - （仅限Android）
• guestsCanInviteOther（boolean） - （仅限Android）
• guestsCanSeeGuests（boolean） - （仅限Android）

返回
代表新创建事件ID的字符串。

Expo.Calendar.updateEventAsync（id，details，recurrentEventOptions）
更新设备上存储的现有日历的详细信息。要删除一个属性，明确地将其设置为null。

参数
id（字符串） - 要更新的事件的ID。需要。

details（object） -

要更新的属性的地图（请参阅下面的这些字段的说明）：

• title（string）
• startDate（Date）
• endDate（Date）
• allDay（布尔）
• Location（string）
• notes（string）
• alarms (Array)
• alarms (Array)
• alarms (Array)
• timeZone（string）
• endTimeZone（string） - （仅限Android）
• url（string） - （仅iOS）
• organizerEmail（string） - （仅限Android）
• accessLevel（string） - （仅限Android）
• guestsCanModify（boolean） - （仅限Android）
• guestsCanInviteOther（boolean） - （仅限Android）
• guestsCanSeeGuests（boolean） - （仅限Android）

recurrentEventOptions（对象） -

重复性事件的选项图：

• instanceStartDate（Date） - 如果想更新循环事件的单个实例，则表示所需实例的开始时间的Date对象。如果未提供此信息，并且id代表周期性事件，则该事件的第一个实例将默认更新。
• futureEvents（boolean） - 是否也应更新循环系列中的未来事件。如果为true，则将给定的更改应用于由instanceStartDate指定的循环实例以及系列中的所有未来事件。如果为false，则仅将给定更改应用于由instanceStartDate指定的实例。

Expo.Calendar.deleteEventAsync（id，recurringEventOptions）
从设备中删除现有的事件。谨慎使用。

参数
id（string） - 要删除的事件的ID。需要。

recurrentEventOptions（对象） -

重复性事件的选项图：

• instanceStartDate（Date） - 表示期望实例的开始时间的Date对象，如果想要删除循环事件的单个实例。如果没有提供，并且id代表周期性事件，则该事件的第一个实例将在默认情况下被删除。
• futureEvents（boolean） - 是否也应删除循环系列中的未来事件。如果为true，将删除instanceStartDate指定的实例以及系列中所有将来的事件。如果为false，则只会删除instanceStartDate指定的实例。

Expo.Calendar.getAttendeesForEventAsync（eventId，recurringEventOptions）
获取给定事件（或循环事件的实例）的所有与会者。

参数
eventId（字符串） - 要返回参加者的事件的ID。需要。

recurringEventOptions（object） -

重复性事件的选项图：

• instanceStartDate（Date） - 如果查找循环事件的单个实例，则表示所需实例的开始时间的Date对象。如果未提供，并且eventId表示重复性事件，则该事件的第一个实例的参与者将默认返回。

返回
与指定事件关联的参与者对象数组。

Expo.Calendar.createAttendeeAsync（eventId，details）
仅在Android上提供。创建新的记录并将其添加到指定的事件中。请注意，如果eventId指定了重复事件，则会将与会者添加到事件的每个实例。

参数
eventId（string） - 要将此与会者添加到的事件的ID。需要。

details（object） -

要创建的与会者的详细信息地图（请参阅下面有关这些字段的说明）：

• id（字符串）必需。
• email (string) 必需。
• name (string)
• role (string) 必需。
• status (string) 必需。
• type (string) 必需。

返回
代表新创建的与会者记录ID的字符串。

Expo.Calendar.updateAttendeeAsync（id，details）
仅在Android上提供。更新现有的与会者记录。要删除一个属性，明确地将其设置为null。

参数
id（字符串） - 要更新的与会者记录的ID。需要。

details（object） -

要更新的属性的地图（请参阅下面的这些字段的说明）：

• id（string）
• email（string）
• name（string）
• role（string）
• status（string）
• type（string）

Expo.Calendar.deleteAttendeeAsync（ID）
仅在Android上提供。从设备中删除现有的与会者记录。谨慎使用。

参数
id（string） - 要删除的与会者的ID。

Expo.Calendar.getRemindersAsync（calendarIds，status，startDate，endDate）
仅适用于iOS。返回与提供的条件匹配的提醒列表。

参数

• calendarIds（array） - 要搜索提醒的日历的ID列表。必需。
• status（string） - Calendar.ReminderStatus.COMPLETED或Calendar.ReminderStatus.INCOMPLETE之一。
• startDate（Date） - 搜索提醒的时间段开始。如果定义了状态，则为必需。
• endDate（Date） - 搜索提醒的时间段结束。如果定义了状态，则为必需。

返回
与搜索条件匹配的Reminder对象数组。

Expo.Calendar.getReminderAsync（ID）
仅适用于iOS。返回由ID选择的特定提醒。

参数
id（string） - 要返回的提醒的ID。需要。

返回
与提供的ID匹配的提醒对象（如果存在）。

Expo.Calendar.createReminderAsync（calendarId，details）
仅适用于iOS。在指定的日历上创建新的提醒。

参数
calendarId（字符串） - 创建此提醒的日历的ID。必需。

details（object） -

要创建提醒的详细信息地图:(请参阅下面有关这些字段的说明）

• title（string）
• startDate（Date）
• dueDate（Date）
• completed (boolean)
• completionDate（Date）
• location (string)
• notes (string)
• alarms (array)

• recurrenceRule (RecurrenceRule)

• timeZone (string)

• url (string)

返回
代表新创建的提醒ID的字符串。

Expo.Calendar.updateReminderAsync（id，details）
仅适用于iOS。更新设备上存储的现有提醒的详细信息。要删除一个属性，明确地将其设置为null。

参数
id（字符串） - 要更新的提醒的ID。需要。

details（object） -

要更新的属性的地图（请参阅下面的这些字段的说明）：

• title（string）
• startDate（Date）
• dueDate（Date）
• completionDate（Date） - 设置非空日期的此属性将自动将提醒的完成值设置为true。

• location (string)

• notes (string)

• alarms (array)

• recurrenceRule (RecurrenceRule)

• timeZone (string)

• url (string)

Expo.Calendar.deleteReminderAsync（ID）
仅适用于iOS。从设备中删除现有的提醒。谨慎使用。

参数
id（字符串） - 要删除的提醒的ID。需要。

Expo.Calendar.getSourcesAsync（）
仅适用于iOS。

返回
一个Source对象数组的所有来源存储在设备上的日历。

Expo.Calendar.getSourceAsync（ID）
仅适用于iOS。返回由ID选择的特定源。

参数
id（字符串） - 要返回的源的ID。需要。

返回
与提供的ID匹配的Source对象（如果存在）。

Expo.Calendar.openEventInCalendar（ID）
仅在Android上提供。发送意图在OS日历应用程序中打开指定的事件。

参数
id（字符串） - 要打开的事件的ID。需要。

对于参数的详细列表解释

---

下一张继续介绍，这一篇主要介绍了：expo sdk api之 Calendar,Constants！，欢迎大家关注我的微信公众号，这篇文章是否被大家认可，我的衡量标准就是公众号粉丝增长人数。欢迎大家转载，但必须保留本人博客链接！