Create · Appium 官方文檔

# 創建新的會話（session）創建一個新的會話（session） ## 使用樣例 ```java // Java DesiredCapabilities desiredCapabilities = new DesiredCapabilities(); desiredCapabilities.setCapability(MobileCapabilityType.PLATFORM_VERSION, "10.3"); desiredCapabilities.setCapability(MobileCapabilityType.DEVICE_NAME, "iPhone Simulator"); desiredCapabilities.setCapability(MobileCapabilityType.AUTOMATION_NAME, "XCUITest"); desiredCapabilities.setCapability(MobileCapabilityType.APP, "/path/to/ios/app.zip"); URL url = new URL("http://127.0.0.1:4723/wd/hub"); IOSDriver driver = new IOSDriver(url, desiredCapabilities); String sessionId = driver.getSessionId().toString(); ``` ```python # Python desired_caps = { 'platformName': 'Android', 'platformVersion': '7.0', 'deviceName': 'Android Emulator', 'automationName': 'UiAutomator2', 'app': PATH('/path/to/app') } self.driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps) ``` ```javascript // Javascript // webdriver.io example let options = { desiredCapabilities: { platformName: 'Android', platformVersion: '7.0', automationName: 'UiAutomator2', app: path.resolve('path', 'to', 'app.apk') }}; let client = driver.newSession(options); // wd example let driver = await wd.promiseChainRemote({ host: '127.0.0.1', port: 4723 }); let desiredCaps = { platformName: 'Android', platformVersion: '7.0', deviceName: 'Android Emulator', app: path.resolve('path', 'to', 'app.apk') }; await driver.init(desiredCaps); ``` ```ruby # Ruby # ruby_lib example APP_PATH = '../../path/to/app.app' desired_caps = { caps: { platformName: 'iOS', platformVersion: '10.2', deviceName: 'iPhone 6', app: APP_PATH, automationName: "XCUITest" } } Appium::Driver.new(desired_caps).start_driver # ruby_lib_core example ::Appium::Core.for(desired_caps).start_driver ``` ```php # PHP // TODO PHP sample ``` ```csharp // C# AppiumOptions capabilities = new AppiumOptions(); appiumOptions.AddAdditionalCapability(MobileCapabilityType.PlatformName, "Android"); appiumOptions.AddAdditionalCapability(MobileCapabilityType.PlatformVersion, "7.1.1"); appiumOptions.AddAdditionalCapability(MobileCapabilityType.DeviceName, "Android Device"); appiumOptions.AddAdditionalCapability("appPackage", "com.instagram.android"); appiumOptions.AddAdditionalCapability("appActivity", "com.instagram.android.activity.MainTabActivity"); AndroidDriver<AndroidElement> driver = new AndroidDriver<AndroidElement>(new Uri("http://127.0.0.1:4723/wd/hub"), appiumOptions); ``` ## 描述服務器應嘗試創建一個與desired capabilities以及Required capabilities中各項最匹配的會話。 * [JSONWP規范](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#session-1) Required capabilities比desired capabilities有更高的優先級，并且創建會話（session）時Required capabilities必須被設置。 * [W3C 規范](https://www.w3.org/TR/webdriver/#dfn-new-session) capabilities.alwaysMatch在創建會話（session）時必須被設置; capabilities.firstMatch 必須匹配至少一項 (第一個匹配項會被使用) ## 支持 ### Appium Server |平臺|Driver|平臺版本|Appium版本|Driver版本| |--------|----------------|------|--------------|--------------| | iOS | [XCUITest](../../drivers/ios-xcuitest.md) | 9.3+ | 1.6.0+ | All | | | [UIAutomation](../../drivers/ios-uiautomation.md) | 8.0 to 9.3 | All | All | | 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) | ?+ | 1.6.4+ | All | | Windows | [Windows](../../drivers/windows.md) | 10+ | 1.6.0+ | All | ### Appium客戶端 |語言|支持版本|文檔| |--------|-------|-------------| |[Java](https://github.com/appium/java-client/releases/latest)| All | [seleniumhq.github.io](https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/remote/server/DefaultSession.html#createSession-org.openqa.selenium.remote.server.DriverFactory-org.openqa.selenium.remote.server.Clock-org.openqa.selenium.remote.SessionId-org.openqa.selenium.Capabilities-) | |[Python](https://github.com/appium/python-client/releases/latest)| All | [selenium-python.readthedocs.io](http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webelement.WebElement.clear) | |[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#L1780) | |[Ruby](https://github.com/appium/ruby_lib/releases/latest)| All | [www.rubydoc.info](https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:clear) | |[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/) | ## HTTP API規范 ### 終端 `POST /session` ### URL參數 None ### JSON參數 |名稱|類型|描述| |----|----|-----------| | desiredCapabilities | `object` | ([JSONWP 規范](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#session-1)) 對象，描述創建會話所需的 [desired capabilities](../../writing-running-appium/caps.md) | | requiredCapabilities | `object` | ([JSONWP 規范](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#session-1)) 對象，描述創建會話所需的 required capabilities，一定被移動端應用 | | capabilities | `object` | ([W3C 規范](https://www.w3.org/TR/webdriver/#dfn-new-session)) 對象，包含'alwaysMatch' and 'firstMatch' 屬性 | | capabilities.alwaysMatch | `object` | 移動端必須匹配的[desired capabilities](../../writing-running-appium/caps.md) | | capabilities.firstMatch | `array<object>` | capabilities的數組，移動端會嘗試在其中進行匹配。匹配數組中的第一個。 | ### 響應一個描述會話（session）的 capabilities的對象 (`object`) ## 參考 * [W3C Specification](https://www.w3.org/TR/webdriver/#dfn-new-session) * [JSONWP Specification](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#session-1) 本文由 [KangarooChen](https://github.com/KangarooChen) 翻譯，Last english version: 1be5bd8c1e22fe46188dd9c498766ae587c88887, 4 Mar 2020