本文今后將只在 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默認項目全面轉(zhuǎn)向ES6恢共，語法大變化战秋，請參考此貼學(xué)習http://bbs.reactnative.cn/topic/15
歡迎加入QQ討論群439022088，本群同時討論RN和react.js
一般問題
Q：RN和React.js是一個東西嗎讨韭？
A：RN和React.js共用一些抽象層脂信，但具體有很多差異，且目標平臺不同：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ǎ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”（當然要先確定這個版本已經(jīng)發(fā)布到npm上了考余，如果配置中有^或~之類的符號先嬉，可以參考這篇文章來了解其含義。）楚堤。
然后在當前目錄的命令行中執(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標簽切換到前臺再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)用麥克風末秃？等等
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
