React Native使用指南-使用链接库
并不是所有的APP都需要使用全部的原生功能,包含支持全部特性的代碼會增大應用的體積。但我們仍然希望能讓你簡單地根據自己的需求添加需要的特性。
在這種思想下,我們把許多特性都發布成為互不相關的靜態庫。
大部分的庫只需要拖進兩個文件就可以使用了,偶爾你還需要幾步額外的工作,但不會再有更多的事情要做了。
我們隨著React Native發布的所有庫都在倉庫中的Libraries文件夾下。其中有一些是純Javascript代碼,你只需要去require它們就可以使用了。另外有一些庫基于一些原生代碼實現,你必須把這些文件添加到你的應用,否則應用會在你使用這些庫的時候產生報錯。
添加包含原生代碼的庫需要幾個步驟:
自動鏈接
"rnpm"是一個社區項目,可以提供原生依賴的自動鏈接。
第一步
首先安裝rnpm:?
$ npm install rnpm -g注意:?rnpm需要node?4.1或更高版本。
第二步
安裝一個帶原生依賴的庫:?
$ npm install <library-with-native-dependencies> --save注意:?這一步中--save或--save-dev參數是非常重要的。rnpm需要根據package.json文件中的dependencies和devDependencies記錄來鏈接庫。
第三步
鏈接原生依賴:?
$ rnpm link完成了!現在所有的原生依賴都成功地鏈接到你的iOS/Android項目了。
手動鏈接
第一步
如果該庫包含原生代碼,那么在它的文件夾下一定有一個.xcodeproj文件。 把這個文件拖到你的XCode工程下(通常拖到XCode的Libraries分組里)
第二步
點擊你的主工程文件,選擇Build Phases,然后把剛才所添加進去的.xcodeproj下的Products文件夾中的靜態庫文件(.a文件),拖到Link Binary With Libraries組內。
第三步
不是所有的庫都需要進行這個步驟,你需要考慮的問題在于:
我需要在編譯的期間了解庫的內容嗎?
這個問題的意思是,你是需要在原生代碼中使用這個庫,還是只需要通過JavaScript訪問?如果你只需要通過JavaScript訪問這個庫,你就可以跳過這步了。
這一步驟對于我們隨React Native發布的大部分庫來說都不是必要的,但有兩個例外是PushNotificationIOS和LinkingIOS。
以PushNotificationIOS為例,你需要在AppDelegate每收到一條推送通知之后,調用庫中的一個方法。
這種情況下我們需要能夠訪問到庫的頭文件。為了能夠順利打包,你需要打開你的工程文件,選擇Build Settings,然后搜索Header Search Paths,然后添加庫所在的目錄(如果它還有像React這樣的子目錄需要包含,注意要選中recursive選項)
本文轉自React Native中文網:http://reactnative.cn/docs/0.20/linking-libraries-ios.html#content
總結
以上是生活随笔為你收集整理的React Native使用指南-使用链接库的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: CoreAnimation编程指南(二)
- 下一篇: 如何在摆摊经济中脱颖而出