# 啟動Activity 通過提供包名和Activity名來啟動一個Android Activity ## 使用樣例 ```java // Java driver.startActivity(new Activity("com.example", "ActivityName")); ``` ```python # Python self.driver.start_activity("com.example", "ActivityName"); ``` ```javascript // Javascript // webdriver.io example driver.startActivity("com.example", "ActivityName"); // wd example await driver.startActivity({ appPackage: "com.example", appActivity: "ActivityName" }); ``` ```ruby # Ruby # ruby_lib example start_activity app_package: "com.example", app_activity: "ActivityName" # ruby_lib_core example @driver.start_activity app_package: "com.example", app_activity: "ActivityName" ``` ```php # PHP $driver->startActivity(array('appPackage' => 'com.example', 'appActivity' => 'ActivityName')); ``` ```csharp // C# driver.StartActivity("com.example", "ActivityName"); ``` ## 支持 ### Appium Server |平臺|Driver|平臺版本|Appium版本|Driver版本| |--------|----------------|------|--------------|--------------| | iOS | [XCUITest](../../drivers/ios-xcuitest.md) | None | None | None | | | [UIAutomation](../../drivers/ios-uiautomation.md) | None | None | None | | Android | [Espresso](../../drivers/android-espresso.md) | ?+ | 1.9.0+ | All | | | [UiAutomator2](../../drivers/android-uiautomator2.md) | ?+ | 1.6.0+ | All | | | [UiAutomator](../../drivers/android-uiautomator.md) | 4.3+ | All | All | | Mac | [Mac](../../drivers/mac.md) | None | None | None | | Windows | [Windows](../../drivers/windows.md) | None | None | None | ### Appium客戶端 |語言|支持版本|文檔| |--------|-------|-------------| |[Java](https://github.com/appium/java-client/releases/latest)| All | [appium.github.io](https://appium.github.io/java-client/io/appium/java_client/android/AndroidMobileCommandHelper.html#startActivityCommand-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-boolean-) | |[Python](https://github.com/appium/python-client/releases/latest)| All | [appium.github.io](https://appium.github.io/python-client-sphinx/webdriver.extensions.android.html#webdriver.extensions.android.activities.Activities.start_activity) | |[Javascript (WebdriverIO)](http://webdriver.io/index.html)| All | | |[Javascript (WD)](https://github.com/admc/wd/releases/latest)| All | [github.com](https://github.com/admc/wd/blob/master/lib/commands.js#L2948) | |[Ruby](https://github.com/appium/ruby_lib/releases/latest)| All | [www.rubydoc.info](https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#start_activity-instance_method) | |[PHP](https://github.com/appium/php-client/releases/latest)| All | [github.com](https://github.com/appium/php-client/) | |[C#](https://github.com/appium/appium-dotnet-driver/releases/latest)| All | [github.com](https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs) | ## HTTP API 規范 ### 終端 `POST /session/:session_id/appium/device/start_activity` ### URL參數 |名稱|描述| |----|-----------| |session_id|將指令發往的會話（session）的ID| ### JSON參數 |名稱|類型|描述| |----|----|-----------| | appPackage | `string` | [包](https://developer.android.com/reference/java/lang/Package.html)名 | | appActivity | `string` | [Activity](https://developer.android.com/reference/android/app/Activity.html)名 | | appWaitPackage | `string` | 在這個參數指定的包啟動后，自動化才會開始 | | intentAction | `string` | 啟動活動時使用的[action](https://developer.android.com/reference/android/content/Intent.html) | | intentCategory | `string` | 啟動活動時使用的Category | | intentFlags | `string` | 啟動活動時使用的標記 | | optionalIntentArguments | `string` | 啟動活動時使用的附加參數 | | dontStopAppOnReset | `boolean` | 重置活動時是否需要殺掉App | ### 響應 null ## 參考 * [JSONWP Specification](https://github.com/appium/appium-base-driver/blob/master/lib/protocol/routes.js#L525) 本文由 [KangarooChen](https://github.com/KangarooChen) 翻譯，Last english version: a11f693bbe2bcf2e47fa6a40872a7580ab45d6bb, 6 Jun 2020