本文今后將只在 ReactNative中文網(wǎng)?進(jìn)行更新，此處不再維護(hù)，請(qǐng)點(diǎn)擊這里移步。
本文主要收集在React Native(以下簡(jiǎn)稱RN)的編譯/運(yùn)行/開(kāi)發(fā)中的常見(jiàn)問(wèn)題與參考解決方案，并非完整教程。
本文最后更新時(shí)間2016年1月19日，對(duì)應(yīng)rn版本0.18
0.18正式版有一個(gè)bug，導(dǎo)致無(wú)論在win還是mac下新建的項(xiàng)目都無(wú)法正常運(yùn)行，請(qǐng)參閱此貼解決
從0.18開(kāi)始，RN默認(rèn)項(xiàng)目全面轉(zhuǎn)向ES6，語(yǔ)法大變化，請(qǐng)參考此貼學(xué)習(xí)http://bbs.reactnative.cn/topic/15
歡迎加入QQ討論群439022088，本群同時(shí)討論RN和react.js
一般問(wèn)題
Q：RN和React.js是一個(gè)東西嗎？
A：RN和React.js共用一些抽象層，但具體有很多差異，且目標(biāo)平臺(tái)不同：RN目前只能開(kāi)發(fā)iOS/Android App，而React.js用于開(kāi)發(fā)web頁(yè)面。
Q：RN有哪些已經(jīng)上架的案例？
A：官方最近推出了一個(gè)由愛(ài)好者自行提交的showcase頁(yè)面。
Q：RN可以在windows下開(kāi)發(fā)嗎？
A：對(duì)于iOS開(kāi)發(fā)，可以通過(guò)虛擬機(jī)等方式，但很麻煩也不推薦。做iOS開(kāi)發(fā)，遲早你都需要一臺(tái)Mac電腦。
對(duì)于Android開(kāi)發(fā)，理論上沒(méi)問(wèn)題。但由于FB的員工基本都用mac，沒(méi)有怎么管過(guò)windows兼容性，所以目前的版本可能在windows上會(huì)遇到一些問(wèn)題。
具體搭建方法可參考：@天地之靈 總結(jié)的完整的windows環(huán)境搭建指南
Q：RN所支持的最低iOS和Android版本？
A：Android >= 4.1 (API 16)
iOS >= 7.0
Q：RN和cordova/phonegap是一個(gè)東西嗎？
A：不一樣。RN不是一個(gè)webview（但包含了webview組件），不能直接復(fù)用web頁(yè)面代碼。RN的性能接近原生，超過(guò)cordova/phonegap。
Q：可以使用現(xiàn)有的js庫(kù)嗎？
A：由于RN理論上更接近nodejs的運(yùn)行環(huán)境，所以對(duì)nodejs的庫(kù)兼容更好一些。瀏覽器端的js庫(kù)，涉及到DOM、BOM、CSS等功能的模塊無(wú)法使用，因?yàn)镽N的環(huán)境中沒(méi)有這些東西。
Q：可以使用現(xiàn)有的objc/swift/java庫(kù)嗎？
環(huán)境搭建與編譯問(wèn)題
Q：創(chuàng)建新項(xiàng)目，react native init xxx命令長(zhǎng)時(shí)間無(wú)響應(yīng)，或報(bào)錯(cuò)shasum check failed
A：由于眾所周知的網(wǎng)絡(luò)原因，react-native命令行從npm官方源拖代碼時(shí)會(huì)遇上麻煩。請(qǐng)將npm倉(cāng)庫(kù)源替換為國(guó)內(nèi)鏡像：
npm config set registry https://registry.npm.taobao.org
npm config set disturl https://npm.taobao.org/dist
另，執(zhí)行init時(shí)切記不要在前面加上sudo（否則新項(xiàng)目的目錄所有者會(huì)變?yōu)閞oot而不是當(dāng)前用戶，導(dǎo)致一系列權(quán)限問(wèn)題，請(qǐng)使用chown修復(fù)）。
11月1日更新：react-native.cn中文網(wǎng)提供了完整的綠色純凈新項(xiàng)目包。完整打包全部iOS和Android的第三方依賴，只要環(huán)境配置正確，無(wú)需科學(xué)上網(wǎng)漫長(zhǎng)等待，即可直接運(yùn)行。
Q：報(bào)錯(cuò)EACCES: permission denied, open 'Users/你的用戶名/.babel.json'
A：執(zhí)行如下命令：
sudo chown 你的用戶名 ~/.babel.json
Q：如何升級(jí)RN版本？
A：請(qǐng)用編輯器打開(kāi)項(xiàng)目目錄中的package.json，找到類(lèi)似下面的一行配置
"react-native": "0.13.0",
將其改為要升級(jí)的版本號(hào)，如“0.15.0-rc”（當(dāng)然要先確定這個(gè)版本已經(jīng)發(fā)布到npm上了，如果配置中有^或~之類(lèi)的符號(hào)，可以參考這篇文章來(lái)了解其含義。）。
然后在當(dāng)前目錄的命令行中執(zhí)行npm i
如果提示權(quán)限錯(cuò)誤則在前面加上sudo（windows下不需要）.
npm i執(zhí)行完畢且成功不報(bào)錯(cuò)之后，在項(xiàng)目目錄中運(yùn)行
react-native upgrade
對(duì)于0.14以下版本升級(jí)0.14的情況，還需要額外手動(dòng)處理一下。
Q：報(bào)錯(cuò)：EMFILE, too many open files '......'
A：請(qǐng)檢查node版本（4.0以上），以及是否安裝了watchman（目前只有Mac能裝這個(gè)）
Q：報(bào)錯(cuò)：SyntaxError: Use of const in strict mode
A：請(qǐng)檢查node版本（4.0以上）。
Q：Windows下報(bào)錯(cuò)：ERROR? Watcher took too long to load
Try running `watchman version` from your terminal
A：請(qǐng)參照此文底部的說(shuō)法修改。
Q：報(bào)錯(cuò)：Invariant Violation:Application XXXX has not been registered.
A：請(qǐng)確保index.ios.js中的
AppRegistry.registerComponent('項(xiàng)目名',() => ...);
與appDelegate.m中的
RCTRootView*rootView = [[RCTRootViewalloc]initWithBundleURL:jsCodeLocation
moduleName:@"項(xiàng)目名" launchOptions:launchOptions];
或是MainActivity.java中的
mReactRootView.startReactApplication(mReactInstanceManager, "項(xiàng)目名", null);
都保持一致。
Q：應(yīng)該使用什么IDE開(kāi)發(fā)？
A：雖然常用的JS編輯器很多，但由于RN大量使用jsx和es6語(yǔ)法，目前只有sublime text（通過(guò)插件）和webstorm（10以上版本）提供了良好的支持。筆者推薦webstorm，因?yàn)樗懈晟频恼Z(yǔ)法提示和補(bǔ)全。另外雖然主要的業(yè)務(wù)邏輯是使用js開(kāi)發(fā)，但仍然要依賴于原生的編譯/調(diào)試環(huán)境，所以你還需要同時(shí)運(yùn)行Xcode（iOS）或Android Studio（android）等。
開(kāi)發(fā)與調(diào)試問(wèn)題
Q：如何開(kāi)啟調(diào)試功能？
A：點(diǎn)擊iOS模擬器頂部的Hardware菜單，選擇Shake Gesture（對(duì)應(yīng)真機(jī)搖一搖），會(huì)自動(dòng)彈出如下圖的菜單。
安卓模擬器則是點(diǎn)擊菜單鍵，真機(jī)上沒(méi)有菜單鍵的，搖一搖即可。
選擇Debug in Chrome即會(huì)啟動(dòng)Chrome作為運(yùn)行和調(diào)試環(huán)境（注意此時(shí)JS引擎為Chrome的V8，與iOS真機(jī)的javascriptCore引擎存在一些差異）。選擇Inspect Element即可以像調(diào)試網(wǎng)頁(yè)元素一樣查看布局元素的樣式，但比較簡(jiǎn)陋。React Devtools插件可裝可不裝，它只用來(lái)查看布局，不影響調(diào)試，且在目前的版本（>0.13）中還無(wú)法正常加載。
Q：調(diào)試模式下報(bào)錯(cuò)：Runtime is not ready. Make sure...或是socket closed.
A：有時(shí)Chrome進(jìn)程會(huì)失去響應(yīng)，可以嘗試手動(dòng)將Chrome的React Native Debugger標(biāo)簽切換到前臺(tái)再Reload模擬器頁(yè)面。
Q：使用ListView時(shí)報(bào)錯(cuò)：Sticky header index 0 was outside the range {...}
A：看起來(lái)是個(gè)數(shù)組越界錯(cuò)誤，但多數(shù)情況下是由于ListView的子組件渲染錯(cuò)誤（如套數(shù)據(jù)時(shí)沒(méi)有檢查undefined等）引起，而非ListView本身的問(wèn)題。
Q：ListView的數(shù)據(jù)到底應(yīng)該怎么配？
A：參考下圖
Q：require靜態(tài)圖片時(shí)報(bào)找不到模塊的錯(cuò)誤
A：參看下圖步驟，尤其需要注意的點(diǎn)是文件名必須和imageset的名字一致。（注：這里演示的是0.14之前版本的添加圖片的步驟。0.14之后的圖片用法點(diǎn)這里）
Q：使用Image時(shí)報(bào)錯(cuò)：You are trying to render the global Image variable as a React element. You probably forgot to require Image.
A：由于React的Image組件和全局的Image對(duì)象重名，所以使用Image組件時(shí)一定要記得在文件開(kāi)頭正確引入React的Image組件。
Q：在使用Navigator的同時(shí)使用ListView或ScrollView，后兩者的頭部會(huì)多出一些空間。
A：將automaticallyAdjustContentInsets屬性設(shè)為{false}.
Q：有一些示例代碼中有奇怪的問(wèn)號(hào)，比如function foo(x:?string)，代表什么意思？
A：這是通過(guò)一個(gè)名為flow的外部工具為javascript加上強(qiáng)類(lèi)型檢查的功能，不影響編譯和運(yùn)行。
Q：報(bào)錯(cuò)：Adjacent JSX elements must be wrapped in an enclosing tag.
A：render方法中必須只能包含一個(gè)根元素。
Q：報(bào)錯(cuò)：Invariant Violation: onlyChild must be passed a children with exactly one child
A：一般是Touchable開(kāi)頭的幾個(gè)組件，如果沒(méi)有子元素或者指定多個(gè)并列子元素都會(huì)報(bào)錯(cuò)。
Q：如何獲取服務(wù)器端數(shù)據(jù)/可以使用Ajax嗎？
A：可以用ajax，以及大部分現(xiàn)有的ajax庫(kù)，而且不受瀏覽器跨域限制。官方推薦用更簡(jiǎn)單的fetch api來(lái)替代傳統(tǒng)的ajax.但目前還無(wú)法在Chrome中直接觀測(cè)請(qǐng)求的詳情。
Q：如何讀寫(xiě)文件？如何調(diào)用攝像頭？如何調(diào)用麥克風(fēng)？等等
A：對(duì)于官方?jīng)]有提供的組件或API，請(qǐng)自行在react.parts或github中搜索第三方實(shí)現(xiàn)。如果搜不到相關(guān)結(jié)果，你只能考慮自己用原生代碼實(shí)現(xiàn)后整合進(jìn)來(lái)。
Q：如何在原生代碼中調(diào)用JS方法？
A：請(qǐng)參閱官網(wǎng)中Native Modules一節(jié)文檔，其中提供了回調(diào)Callbacks和監(jiān)聽(tīng)事件兩種方法，且都為異步。
//To be continued
