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