Skip to content

Commit 8762c50

Browse files
authored
docs: fix broken links in appium.io (appium#14067)
* docs: fix broken links in appium.io * re-generate docs * fix a broken link * revert cn since they had broken links * fix links * delete unused files * update chrome link * fix lint * remove line number in python links
1 parent 3019ea8 commit 8762c50

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+61
-825
lines changed

commands-yml/commands/session/events/get-events.yml

+1-3
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,7 @@ example_usage:
3535
client_docs:
3636
java:
3737
- url: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/WebElement.html#click--"
38-
python:
39-
- android: "https://github.com/appium/python-client/android-command"
40-
ios: "https://github.com/appium/python-client/ios-command"
38+
python: "https://github.com/appium/python-client/blob/master/appium/webdriver/extensions/log_event.py"
4139
javascript_wdio: "https://webdriver.io/docs/api/appium.html#getevents"
4240
javascript_wd: "https://github.com/admc/wd/releases"
4341
ruby: "https://www.rubydoc.info/gems/appium_lib/Appium/Driver#log_event-instance_method"

commands-yml/commands/session/events/log-event.yml

+2-4
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description:
66
|
77
This API allows us to store a custom event.
88

9-
Appium provides [Appium Event Timing](docs/en/advanced-concepts/event-timings/) to track when events happen.
9+
Appium provides [Appium Event Timing](/advanced-concepts/event-timings/) to track when events happen.
1010
This custom event feature allow users to store a custom event as the feature.
1111

1212
example_usage:
@@ -43,9 +43,7 @@ example_usage:
4343
client_docs:
4444
java:
4545
- url: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/WebElement.html#click--"
46-
python:
47-
- android: "https://github.com/appium/python-client/android-command"
48-
ios: "https://github.com/appium/python-client/ios-command"
46+
python: https://github.com/appium/python-client/blob/master/appium/webdriver/extensions/log_event.py
4947
javascript_wdio: "https://webdriver.io/docs/api/appium.html#logevent"
5048
javascript_wd: "https://github.com/admc/wd/releases"
5149
ruby: "https://www.rubydoc.info/gems/appium_lib/Appium/Driver#log_event-instance_method"

commands-yml/commands/web/storage/delete-all-cookies.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,8 @@ client_docs:
3333
python: "http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webdriver.WebDriver.delete_all_cookies"
3434
javascript_wdio: "https://webdriver.io/docs/api/browser/deleteCookies.html"
3535
javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1993"
36-
ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:delete_all_cookies"
37-
ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:delete_all_cookies"
36+
ruby: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#delete-all-cookies"
37+
ruby_core: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#delete-all-cookies"
3838
php: "https://github.com/appium/php-client/" # TODO PHP documentation link
3939
csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link
4040

commands-yml/commands/web/storage/delete-cookie.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,8 @@ client_docs:
3333
python: "http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webdriver.WebDriver.delete_cookie"
3434
javascript_wdio: "https://webdriver.io/docs/api/webdriver.html#deletecookie"
3535
javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2007"
36-
ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:delete_cookie"
37-
ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:delete_cookie"
36+
ruby: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#delete-cookie"
37+
ruby_core: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#delete-cookie"
3838
php: "https://github.com/appium/php-client/" # TODO PHP documentation link
3939
csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link
4040

commands-yml/commands/web/storage/get-all-cookies.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,8 @@ client_docs:
3333
python: "http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webdriver.WebDriver.get_cookies"
3434
javascript_wdio: "https://webdriver.io/docs/api/browser/getCookies.html"
3535
javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1957"
36-
ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:all_cookies"
37-
ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:all_cookies"
36+
ruby: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#get-all-cookies"
37+
ruby_core: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#get-all-cookies"
3838
php: "https://github.com/appium/php-client/" # TODO PHP documentation link
3939
csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link
4040

commands-yml/commands/web/storage/set-cookie.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,8 @@ client_docs:
3636
python: "http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webdriver.WebDriver.add_cookie"
3737
javascript_wdio: "https://webdriver.io/docs/api/browser/setCookies.html"
3838
javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1971"
39-
ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:add_cookie"
40-
ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Options:add_cookie"
39+
ruby: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#add-cookie"
40+
ruby_core: "https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#add-cookie"
4141
php: "https://github.com/appium/php-client/" # TODO PHP documentation link
4242
csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link
4343

docs/cn/about-appium/intro.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Appium 的 `beta` 版本可以通过 NPM 使用 `npm install -g appium@beta` 指
6060

6161
### 入门指南
6262

63-
恭喜!你现在有足够的知识来使用 Appium 了。 为什么不前往 [入门指南](/docs/cn/about-appium/getting-started.md) 了解更多详细的要求和指南呢?
63+
恭喜!你现在有足够的知识来使用 Appium 了。 为什么不前往 [入门指南](/docs/en/about-appium/getting-started.md)(English) 了解更多详细的要求和指南呢?
6464

6565
---
6666
EOF.

docs/cn/appium-setup/platform-support.md docs/cn/about-appium/platform-support.md

+8-14
Original file line numberDiff line numberDiff line change
@@ -4,29 +4,26 @@ Appium 支持多种平台以及各种测试方式(native,hybrid,web,真
44

55
### iOS 平台支持
66

7-
获取 iOS 平台下所需的必备条件和安装说明,请查阅 [Running on OS X: iOS](running-on-osx.md)
7+
获取 iOS 平台下所需的必备条件和安装说明,请查阅 [XCUITest Driver](/docs/en/drivers/ios-xcuitest.md)(English)
88

9-
* 版本:7.1 及以上版本
9+
* 版本:9.0 及以上版本
1010
* 设备:iPhone 模拟器,iPad 模拟器,以及 iPhone 和 iPad 的真机
1111
* 是否支持 Native 应用:支持。如在模拟器执行,需要 debug 版本的 .app 包,在真机上运行则需要已签名的 .ipa 包。底层的框架是由苹果的 [XCUITest](https://developer.apple.com/reference/xctest) (或 [UIAutomation](https://web.archive.org/web/20160904214108/https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/) 支持更旧的版本) 所提供支持
12-
* 是否支持移动端浏览器:支持。我们通过移动端的 Safari 进行自动化测试。对于真机,`ios-webkit-remote-debugger` 工具是必须的。可惜的是对于 Safari 的 native 部分的自动化目前还不支持。更多介绍请查看 [mobile web doc](/docs/cn/writing-running-appium/mobile-web.md)
13-
* 是否支持 Hybrid 应用:支持。如使用真机,ios-webkit-remote-debugger 工具也是必须的。更多介绍请查看 [hybrid doc](/docs/cn/advanced-concepts/hybrid.md)
12+
* 是否支持移动端浏览器:支持。我们通过移动端的 Safari 进行自动化测试。对于真机,`ios-webkit-remote-debugger` 工具是必须的。可惜的是对于 Safari 的 native 部分的自动化目前还不支持。更多介绍请查看 [mobile web doc](/docs/en/writing-running-appium/web/mobile-web.md)(English)。
13+
* 是否支持 Hybrid 应用:支持。如使用真机,ios-webkit-remote-debugger 工具也是必须的。更多介绍请查看 [hybrid doc](/docs/cn/writing-running-appium/web/hybrid.md)
1414
* 是否支持在一个 session 中多个应用的自动化:不支持
1515
* 是否支持多设备同时执行自动化:不支持
1616
* 是否支持第三方应用的自动化:仅支持在模拟器上仅有的第三方应用(设置,地图,等等...)。若在 iOS 10 及以上的版本,你同样可以在 home 界面做自动化。
1717
* 是否支持自定义的、非标准的 UI 控件的自动化:只支持小部分。你需要在控件设置可识别的信息,从而对一些元素进行一些基础的自动化操作。
1818

1919
### Android 平台支持
2020

21-
查阅[Running on OS X: Android](running-on-osx.md)[Running on Windows](running-on-windows.md) 或者 [Running on Linux](running-on-linux.md) 查看更多的设备信息以及安装说明。
22-
23-
* 版本:2.3 及以上版本
24-
* 2.3 至 4.2 版本是通过 Appium 绑定的基于 [Instrumentation](http://developer.android.com/reference/android/app/Instrumentation.html)框架的 [Selendroid](http://selendroid.io)实现的自动化。Selendroid 的命令设置与默认的 Appium 有点不同, 支持的配置文件也同样不同。要获得在后台运行自动化的权限,需要环境配置中将 `automationName` 的值为 `Selendroid`
21+
* 版本:4.3 及以上版本
2522
* 4.3 以及更高的版本是通过 Appium 自己的 [UiAutomator](http://developer.android.com/tools/testing-support-library/index.html#UIAutomator) 库实现。这是默认的自动化后台。
2623
* 设备:Android 模拟器以及 Android 真机
2724
* 是否支持 Native 应用:支持
28-
* 是否支持移动端浏览器:支持(除了使用 Selendroid 后台的时候)。Appium 绑定了一个 [Chromedriver](https://code.google.com/p/selenium/wiki/ChromeDriver) 服务,使用这个代理服务进行自动化测试。在 4.2 和 4.3 版本,只能在官方的 Chrome 浏览器或者 Chromium 执行自动化测试。在 4.4 及更高版本,可以在内置的 “浏览器” 应用上进行自动化了。更多介绍请查看 [mobile web doc](/docs/cn/writing-running-appium/mobile-web.md)
29-
* 是否支持 Hybrid 应用:支持。更多介绍请查阅 [hybrid doc](/docs/cn/advanced-concepts/hybrid.md)
25+
* 是否支持移动端浏览器:支持(除了使用 Selendroid 后台的时候)。Appium 绑定了一个 [Chromedriver](http://chromedriver.chromium.org) 服务,使用这个代理服务进行自动化测试。在 4.2 和 4.3 版本,只能在官方的 Chrome 浏览器或者 Chromium 执行自动化测试。在 4.4 及更高版本,可以在内置的 “浏览器” 应用上进行自动化了。更多介绍请查看 [mobile web doc](/docs/en/writing-running-appium/web/mobile-web.md)(English)。
26+
* 是否支持 Hybrid 应用:支持。更多介绍请查阅 [hybrid doc](/docs/cn/writing-running-appium/web/hybrid.md)
3027
* 默认的 Appium 自动化后台:支持 4.4 以及更高版本
3128
* Selendroid 自动化后台:支持 2.3 以及更高版本
3229
* 是否支持多个 app 在同一个 session 中自动化:支持(除了使用 Selendroid 后台的时候)
@@ -36,10 +33,7 @@ Appium 支持多种平台以及各种测试方式(native,hybrid,web,真
3633

3734
### Windows 桌面支持
3835

39-
查看以下文档获取更多信息:
40-
41-
* [Running on Windows](running-on-windows.md)
42-
* [Windows App Testing](/docs/cn/writing-running-appium/windows-app-testing.md)
36+
* [Windows App Testing](/docs/en/drivers/windows.md)(English)
4337

4438

4539
本文由 [thanksdanny](https://testerhome.com/thanksdanny) 翻译,由 [lihuazhang](https://github.com/lihuazhang) 校验。

docs/cn/advanced-concepts/grid.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## Selenium Grid
22

3-
通过服务器参数 `--nodeconfig`,可以将 appium 服务器注册到本地的 [Selenium grid](https://github.com/SeleniumHQ/selenium/wiki/Grid2) ([Grid 的配置文档](http://docs.seleniumhq.org/docs/07_selenium_grid.jsp))
3+
通过服务器参数 `--nodeconfig`,可以将 appium 服务器注册到本地的 [Selenium grid](https://github.com/SeleniumHQ/selenium/wiki/Grid2)
44

55
```center
66
> appium --nodeconfig /path/to/nodeconfig.json
@@ -45,8 +45,6 @@
4545
}
4646
```
4747

48-
[这里](http://www.seleniumhq.org/about/platforms.jsp) 列出了可用的平台。
49-
5048
如果没有给出 `url``host``port`,配置会自动指向 `localhost:whatever-port-Appium-started-on`
5149

5250
如果你的 Appium Server 和 Selenium Grid 没有运行在同一台机器上,为确保 Selenium Grid 连接正常,请在你的 `host` & `url` 上使用外部域名或 IP 地址,而不是 `localhost``127.0.0.1`

docs/cn/appium-setup/android-hax-emulator.md

-13
This file was deleted.

docs/cn/appium-setup/android-setup.md

-43
This file was deleted.

docs/cn/appium-setup/ios-deploy.md

-51
This file was deleted.

docs/cn/appium-setup/real-devices-android.md

-7
This file was deleted.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

0 commit comments

Comments
 (0)