Expo大作戰(三十九)--expo sdk api之 DocumentPicker,Contacts(擷取手機連絡人資訊),Branch

標籤：status   head   命令列   prim   support   手機   它的   社區   instant   

 

簡要：本系列文章講會對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。

ErrorRecovery

Expo.ErrorRecovery.setRecoveryProps（props）
設定任意錯誤恢複屬性。 如果您的項目由於致命的JS錯誤而在生產中崩潰，expo將重新載入您的項目。 如果你已經設定了這些屬性，它們會在exp.errorRecovery下傳遞給你重新載入的項目的初始屬性。 閱讀更多關於Expo的錯誤處理。

參數
props（object） - 如果項目由於致命的JS錯誤而重新載入，則該對象將傳遞到重新載入的項目的初始屬性。

DocumentPicker

提供對系統使用者介面的存取權限，以便從使用者裝置上的可用提供者中選擇文檔。

在iOS上，對於獨立應用程式和ExpoKit項目，DocumentPicker模組需要iCloud權利才能正常工作。您需要在您的app.json檔案中將usesIcloudStorage關鍵字設定為true，如此處所指定的那樣。

另外，對於ExpoKit應用程式，您需要在Xcode中開啟項目，並按照Advanced ExpoKit主題指南中的使用DocumentPicker說明進行操作。

Expo.DocumentPicker.getDocumentAsync（options）
顯示用於選擇文檔的系統UI。

參數
options(object) -

選項圖：

• type（string） - 可供選擇的文檔的MIME類型。也支援萬用字元如image / *來選擇任何映像。要允許任何類型的檔案，您可以使用* / *。預設為* / *。

返回
如果使用者取消了檔案揀配，則返回{type：‘cancel‘}。

否則，返回{type：‘success‘，uri，name，size}其中uri是本地文檔檔案的URI，name是它的名稱，size是它的大小（以位元組為單位）。

 

Constacts

提供對手機系統連絡人的訪問。

Expo.Contacts.getContactsAsync（options）
擷取系統連絡人中所有條目的列表。這將返回與連絡人條目相關的一組資料。

參數

options(object)

選項圖：

• fields（array） - 一個數組，描述要檢索每個連絡人的欄位。每個元素必須是下表中列出的常量之一。
• pageSize（number） - 將返回的每頁連絡人數量。預設為100。
• pageOffset（number） - 要返回的連絡人數量。預設為0。

返回
包含以下欄位的分頁對象。

• data（array） - 表單{id，name，firstName，middleName，lastName，nickname，jobTitle，company，department，imageAvailable}的對象數組。 iOS還包括previousLastName。其他欄位列在下表中。
• hasNextPage（boolean） - 如果有更多的連絡人可用。
• hasPreviousPage（boolean） - 如果有連絡人被跳過。傳遞大於0的pageOffset時將為true。
• total (number) - 可用連絡人總數。

Expo.Contacts.getContactByIdAsync（options）
從與指定ID關聯的系統連絡人擷取單個連絡人。

參數對象選項
選項圖：

• id（string） - 要擷取的連絡人的ID。
• fields（array） - 描述要檢索的欄位的數組。每個元素必須是下表中列出的常量之一。

返回
表單{id，name，firstName，middleName，lastName，nickName，jobTitle，company，department，imageAvailable}的對象。 iOS還包括previousLastName。其他欄位列在下表中。

常量和其他欄位(Constants and additional fields)

此表格說明了每個連絡人將按需添加的欄位。樣本用法：Expo.Contacts.EMAILS。

async function showFirstContactAsync() {  // Ask for permission to query contacts.  const permission = await Expo.Permissions.askAsync(Expo.Permissions.CONTACTS);  if (permission.status !== ‘granted‘) {    // Permission was denied...    return;  }  const contacts = await Expo.Contacts.getContactsAsync({    fields: [      Expo.Contacts.PHONE_NUMBERS,      Expo.Contacts.EMAILS,    ],    pageSize: 10,    pageOffset: 0,  });  if (contacts.total > 0) {    Alert.alert(      ‘Your first contact is...‘,      `Name: ${contacts.data[0].name}\n` +      `Phone numbers: ${JSON.stringify(contacts.data[0].phoneNumbers)}\n` +      `Emails: ${JSON.stringify(contacts.data[0].emails)}`    );  }}

該功能將顯示使用者連絡人中的第一個條目。

相互關聯類型（Related types）

phoneNumbers - 一個包含連絡人電話號碼資料的數組。

Fields: { number, digits, primary (boolean), countryCode }

emails- 包含連絡人的電子郵件資料的數組。

Fields: { email, primary (boolean) }

addresses - 包含連絡人的郵政地址資料的數組。

Fields: { street, city, country, region, neighborhood, postalCode, poBox, isoCountryCode }

socialProfiles - 包含連絡人的社交設定檔（Facebook，Twitter等）資料的數組。

Fields：{service，localizedProfile，url，username，userId}

instantMessageAddresses - 包含連絡人的IM地址（Skype，Google Hangouts等）資料的數組。

Fields: { service, username, localizedService }

urls  - 包含連絡人網站網址的數組。

Fields：{url}

dates - 包含分配給連絡人的日期的數組。

Fields：{日，月，年}

relationships - 包含分配連絡人的關係的數組。

Fields：{name}

而且，上面數組中的每個條目都包含參數id和lable。

birthday, nonGregorianBirthday- 連絡人生日的西曆和非格里曆表示。

Fields: { day, month, year }

thumbnail, image (縮圖，映像 )- 縮圖和連絡人圖片的原始映像。

Fields: { uri } - 使用此uri作為<Image>組件的源道具來顯示圖片。請注意，擷取這些內容在iOS上是耗費時間和資源的，並且在擷取所有連絡人時不應使用它們。

 

Branch

expo包括對分支歸因服務的Alpha支援。

注意：此API僅適用於使用exp build建立的獨立版本。

匯入分支
Branch SDK目前位於Expo的DangerZone命名空間下，因為它處於可能發生顯著變化的地方。你可以像這樣匯入它：

import { DangerZone } from ‘expo‘;let { Branch } = DangerZone;

Configuration (standalone apps only)

在android.config.branch.apiKey和ios.config.branch.apiKey部分的app.json中添加Branch Key。您可以在分支儀表板的此頁面上找到您的密鑰。

如果您還沒有連結方案，請在方案部分的app.json中添加連結方案。

Enable Branch support for universal links (iOS only)

Branch可以跟蹤您與應用關聯的域的通用連結。注意：Expo不會通過普通的Linking API將這些內容轉寄給您的JS。

在Apple的Developer Portal上為您的應用ID啟用關聯的域。為此，請在App ID部分中單擊您的應用程式ID。選擇編輯，選中關聯域複選框並點擊完成。

在分支儀表板的連結設定部分啟用通用連結並填寫您的軟體包標識符和Apple App首碼。

在ios.associatedDomains部分中添加關聯域以支援到app.json的通用連結。這應該採用applinks的形式：<link-domain>其中連結域可以在Branch Dashboard的Link Settings頁面的Link Domain部分找到。

Using the Branch API

我們從react-native-branch中提取API，因此文檔是最好的資源。確保您使用上述說明（來自Expo.DangerZone.Branch）匯入Branch。

Listen for links:

Expo.DangerZone.Branch.subscribe((bundle) => {  if (bundle && bundle.params && !bundle.error) {      // `bundle.params` contains all the info about the link.  }});

開啟共用對話方塊：

class ArticleScreen extends Component {  componentDidMount() {    this.createBranchUniversalObject();  }  async createBranchUniversalObject() {    const { article } = this.props;    this._branchUniversalObject = await Expo.DangerZone.Branch.createBranchUniversalObject(      `article_${article.id}`,      {        title: article.title,        contentImageUrl: article.thumbnail,        contentDescription: article.description,        // This metadata can be used to easily navigate back to this screen        // when implementing deep linking with `Branch.subscribe`.        metadata: {          screen: ‘articleScreen‘,          params: JSON.stringify({ articleId: article.id }),        },      }    );  }  onShareLinkPress = async () => {    const shareOptions = {      messageHeader: this.props.article.title,      messageBody: `Checkout my new article!`,    };    await this._branchUniversalObject.showShareSheet(shareOptions);  };}

下一張繼續介紹，這一篇主要介紹了：expo sdk api之 DocumentPicker,Contacts(擷取手機連絡人資訊),Branch！，歡迎大家關注我的公眾號，這篇文章是否被大家認可，我的衡量標準就是公眾號粉絲增長人數。歡迎大家轉載，但必須保留本人部落格連結！

 

 

 

 

Expo大作戰(三十九)--expo sdk api之 DocumentPicker,Contacts(擷取手機連絡人資訊),Branch