2015/2/25 update:
由於testerhome/appium已更新到最新版本，故把 更新程式碼庫部分移到Q&A中。

 

2015/2/24 update:
把標題改為 Appium開發環境搭建（1）--配置原始碼執行環境，同時微調了格式，以配合後續文章。

之前加入了doctorq的開源專案，今天提前配置一下testerhome/appium的原始碼執行環境。過程中發現有一些地方官方文件沒有提到，在此分享一下配置過程。
PS：這是我的第一個貼子，有些地方寫得不對或不夠清晰請跟貼說明，我會立即更正。

1. 下載程式碼庫

git clone https://github.com/testerhome/appium.git
 

然後執行此命令時所在的目錄會出現一個appium資料夾。進入資料夾：

cd appium

3. 根據官方介紹配置從原始碼執行appium的環境（ios, android, seledroid）

3.1 執行appium目錄下的reset.sh 進行環境配置。

這個指令碼進行了各個主要執行環境（ios, android, selendroid）的重置和更新，例如下載需要用到的npm包、安裝selendroid等。
如果執行出錯就加上--verbose引數再跑，看是哪裡出錯。

3.2 （僅針對ios）執行sudo ./bin/authorize-ios.js配置ios的認證環境（用來讓ios不認為appium安裝的應用有安全問題）。

$ sudo ./bin/authorize-ios.js
Password:
Enabling DevToolsSecurity
Updating security db for developer access
Granting access to built-in simulator apps
Authorization successful

3.3 使用node .執行appium server：

$ node .
info: Welcome to Appium v1.3.5 (REV 80453f682c18c32377bdf5664533e4df69a62770)
info: Appium REST http interface listener started on 0.0.0.0:4723
info: Console LogLevel: debug

 

至此，從原始碼執行appium的環境完成了。此時執行的appium就是從原始碼執行的了。如果是debug的話，這樣基本足夠了。但對於開發來說，但這只是配置開發環境的第一步（官方文件裡的Setting up Appium from Source部分），後面還有Hacking on Appium，Hacking with Appium for iOS, Hacking with Appium for Android來配置開發環境，以及Running Tests， Running individual tests來執行測試。後面我會根據官方文件（https://github.com/appium/appium/blob/master/docs/en/contributing-to-appium/appium-from-source.md）配置下去，如果有遇到官方文件內沒有提到的問題，我會另外開貼來幫助大家處理這些問題。

Q&A

更新程式碼庫

$ git fetch git fetch https://github.com/appium/appium.git
git fetch https://github.com/appium/appium.git
remote: Counting objects: 6600, done.
remote: Compressing objects: 100% (2708/2708), done.
remote: Total 6600 (delta 4470), reused 5589 (delta 3679)
Receiving objects: 100% (6600/6600), 15.70 MiB | 260.00 KiB/s, done.
Resolving deltas: 100% (4470/4470), done.
From https://github.com/appium/appium
 * branch            HEAD       -> FETCH_HEAD

$ git checkout master
Warning: you are leaving 1006 commits behind, not connected to
any of your branches:

  80453f6 getting rid of old ci code, use the old-travis-ci branch for reference
  6c8eade Merge pull request #4526 from appium/v1.3.5-branch
  a124a15 clarified garbled changelog text
  634d19b fixed changelog
 ... and 1002 more.

If you want to keep them by creating a new branch, this may be a good time
to do so with:

 git branch new_branch_name 80453f6

Switched to branch 'master'
Your branch is up-to-date with 'origin/master'.


$ git merge FETCH_HEAD
Updating 99794ad..80453f6
Fast-forward
 .gitignore                                         |   21 +-
 .gitmodules                                        |   15 +
 .jscs.json => .jscsrc                              |    8 +-
 .jshintignore                                      |    5 +
 .jshintrc                                          |    2 +-
 .travis.yml                                        |   39 -
 CHANGELOG.txt                                      |  368 ++++-
 CONTRIBUTING.md                                    |  147 +-
 Gruntfile.js                                       |   69 +-
 README.md                                          |   86 +-
 ...
 create mode 100644 test/functional/selendroid/shutdown-specs.js
 create mode 100644 test/functional/selendroid/webview-auto-specs.js
 create mode 100644 test/helpers/sim-udid.js
 create mode 100755 test/tools/prepare-tap.js
 create mode 100644 test/unit/ios-device-specs.js
 create mode 100644 trigger.txt

檢視程式碼庫更新情況：

$ git status
On branch master
Your branch is ahead of 'origin/master' by 1006 commits.
  (use "git push" to publish your local commits)

nothing to commit, working directory clean

注意：這裡的同步僅僅更新了你的原生代碼庫，github上的程式碼庫還是舊的。需要使用git push命令才會把這個變更更新到遠端程式碼庫裡。

執行./reset.sh過程出現的故障及解決方案

• Error: EACCES, mkdir '/Users/hengjiechen/.npm/gulp-util/3.0.3' ``` $ ./reset.sh --verbose ./reset.sh --verbose ---- Resetting / Initializing Appium ---- RESETTING NPM * Installing new or updated NPM modules (including devDeps) npm ERR! Darwin 14.0.0 npm ERR! argv "node" "/usr/local/bin/npm" "install" "." npm ERR! node v0.10.36 npm ERR! npm v2.3.0 npm ERR! path /Users/hengjiechen/.npm/gulp-util/3.0.3 npm ERR! code EACCES npm ERR! errno 3

npm ERR! Error: EACCES, mkdir '/Users/hengjiechen/.npm/gulp-util/3.0.3'
npm ERR! { [Error: EACCES, mkdir '/Users/hengjiechen/.npm/gulp-util/3.0.3']
npm ERR! errno: 3,
npm ERR! code: 'EACCES',
npm ERR! path: '/Users/hengjiechen/.npm/gulp-util/3.0.3',
npm ERR! parent: 'appium' }
npm ERR!
npm ERR! Please try running this command again as root/Administrator.

npm ERR! Please include the following file with any support request:
npm ERR! /Users/hengjiechen/Develop/appiumSourceCode/appium/npm-debug.log
---- FAILURE: reset.sh exited with status 1 ----

**原因分析：**之前用管理員許可權安裝過npm，或者某些npm包用了管理員許可權來安裝。這裡千萬不要參照錯誤提示用管理員執行，否則appium就裝不下去了。
**解決方案：**
解除安裝npm，刪除`~/.npm`資料夾（部分目錄沒許可權就用`sudo`來刪），然後用`brew install npm`重新安裝。安裝後再執行`./reset.sh --verbose`（`brew`命令是`homebrew`的命令，提示沒找到命令的請安裝[homebrew]。不能用node官方安裝程式來裝）

*  Warning: Command failed: /bin/sh: mvn: command not found

...
RESETTING SELENDROID

• Clearing out any old modified server apks
• Cloning/updating selendroid Submodule 'submodules/selendroid' (https://github.com/selendroid/selendroid.git) registered for path 'submodules/selendroid' Cloning into 'submodules/selendroid'... remote: Counting objects: 16818, done. remote: Compressing objects: 100% (70/70), done. remote: Total 16818 (delta 20), reused 35 (delta 11) Receiving objects: 100% (16818/16818), 13.76 MiB | 304.00 KiB/s, done. Resolving deltas: 100% (7885/7885), done. Checking connectivity... done. Submodule path 'submodules/selendroid': checked out 'ec84567bb60cb2f47936aa4213be7ff537d2e596'
• Building selendroid server and supporting libraries Running "buildSelendroidServer" task Building selendroid server Getting Selendroid version Selendroid version is 0.13.0 Unable to build selendroid server. Stdout was:

/bin/sh: mvn: command not found

Warning: Command failed: /bin/sh: mvn: command not found
Use --force to continue.

Aborted due to warnings.
---- FAILURE: reset.sh exited with status 1 ----

**原因分析**：沒找到mvn命令。我沒有裝`maven`。
**解決方案**：參考下一個問題，使用以下命令安裝`maven`

brew install homebrew/versions/maven31
sudo ln -s /usr/local/Cellar/maven31/3.1.1 /usr/local/Cellar/maven/
brew switch maven 3.1.1

*  Warning: Command failed: Exception in thread "pool-2-thread-1" java.lang.NoClassDefFoundError: org/eclipse/aether/spi/connector/Transfer$State

...
constituent[38]: file:/usr/local/Cellar/maven/3.2.5/libexec/lib/wagon-http-shared-2.8.jar
constituent[39]: file:/usr/local/Cellar/maven/3.2.5/libexec/lib/wagon-provider-api-2.8.jar

constituent[40]: file:/usr/local/Cellar/maven/3.2.5/libexec/conf/logging/

Exception in thread "pool-2-thread-1" java.lang.NoClassDefFoundError: org/eclipse/aether/spi/connector/Transfer$State
at org.eclipse.aether.connector.wagon.WagonRepositoryConnector$GetTask.run(WagonRepositoryConnector.java:608)
at org.eclipse.aether.util.concurrency.RunnableErrorForwarder$1.run(RunnableErrorForwarder.java:67)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
...
at org.codehaus.plexus.classworlds.realm.ClassRealm.loadClass(ClassRealm.java:247)
at org.codehaus.plexus.classworlds.realm.ClassRealm.loadClass(ClassRealm.java:239)
... 5 more
Use --force to continue.

Aborted due to warnings.
---- FAILURE: reset.sh exited with status 1 ----

**原因分析**：這是安裝Selendroid時出錯了，錯誤資訊表示是找不到class的宣告。這個只能求助google了。
**解決方案**：google後找到<https://github.com/appium/appium/issues/4490>，根據裡面的解決方案使用下面命令修復：

brew install homebrew/versions/maven31
sudo ln -s /usr/local/Cellar/maven31/3.1.1 /usr/local/Cellar/maven/
brew switch maven 3.1.1

*  [ERROR] Failed to execute goal com.jayway.maven.plugins.android.generation2:android-maven-plugin:3.8.2:generate-sources (default-generate-sources) on project android-driver-app

...
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal com.jayway.maven.plugins.android.generation2:android-maven-plugin:3.8.2:generate-sources (default-generate-sources) on project android-driver-app: Execution default-generate-sources of goal com.jayway.maven.plugins.android.generation2:android-maven-plugin:3.8.2:generate-sources failed: Invalid SDK: Platform/API level 16 not available. This command should give you all you need:
[ERROR] /Applications/adt-bundle-mac-x86_64-20140702/sdk/tools/android update sdk --no-ui --obsolete --force
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/PluginExecutionException
[ERROR]
[ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn -rf :android-driver-app

Warning: Command failed: Use --force to continue.

Aborted due to warnings.
---- FAILURE: reset.sh exited with status 1 ----

**原因分析**：大致意思是沒有找到Android sdk裡的`Platform/API level 16`。官方文件提到配置seledroid的話需要用到level 16的API。
**解決方案**：裝上level 16的API。
![](/photo/2015/5676739fe3196bfa8d18de749d7f5778.png)

*  Warning: Command failed: Feb 14, 2015 3:05:20 PM org.apache.maven.wagon.providers.http.httpclient.impl.client.DefaultRequestDirector tryExecute

[INFO] Compiling 172 source files to /Users/hengjiechen/Develop/appiumSourceCode/appium/submodules/selendroid/selendroid-server/target/classes
[INFO] -------------------------------------------------------------
[ERROR] COMPILATION ERROR :
[INFO] -------------------------------------------------------------
[ERROR] Failure executing javac, but could not parse the error:

The system is out of resources.
Consult the following stack trace for details.
java.lang.StackOverflowError
...
INFO: Retrying request
Feb 14, 2015 3:05:20 PM org.apache.maven.wagon.providers.http.httpclient.impl.client.DefaultRequestDirector tryExecute
INFO: Retrying request

Warning: Command failed: Feb 14, 2015 3:05:20 PM org.apache.maven.wagon.providers.http.httpclient.impl.client.DefaultRequestDirector tryExecute
INFO: I/O exception (java.net.SocketException) caught when processing request: Connection reset
Feb 14, 2015 3:05:20 PM org.apache.maven.wagon.providers.http.httpclient.impl.client.DefaultRequestDirector tryExecute
INFO: I/O exception (java.net.SocketException) caught when processing request: Connection reset
Feb 14, 2015 3:05:20 PM org.apache.maven.wagon.providers.http.httpclient.impl.client.DefaultRequestDirector tryExecute
INFO: Retrying request
Feb 14, 2015 3:05:20 PM org.apache.maven.wagon.providers.http.httpclient.impl.client.DefaultRequestDirector tryExecute
INFO: Retrying request
Use --force to continue.

Aborted due to warnings.
---- FAILURE: reset.sh exited with status 1 ----

**原因分析**：這個原因應該是編譯器暫存空間不足導致的（StackOverflowError）。
**解決方案**：執行下面的命令加大暫存空間：

export MAVEN_OPTS="-Xms1024m -Xmx2048m -Xss2048k"