Expo大作战(四十)--expo sdk api之 Calendar,Constants Expo大作战(一)--什么是exp

Expo大作战(四十)--expo sdk api之 Calendar,ConstantsExpo大作战(一)--什么是exp

简要:本系列文章讲会对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
Returnsexpo,standalone, orguest.。如果是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欢迎大家关注我的微信公众号,这篇文章是否被大家认可,我的衡量标准就是公众号粉丝增长人数。欢迎大家转载,但必须保留本人博客链接!

Expo大作战(四十)--expo sdk api之 Calendar,ConstantsExpo大作战(一)--什么是exp