Index: tools/testing/browser_README.txt |
diff --git a/tools/testing/browser_README.txt b/tools/testing/browser_README.txt |
deleted file mode 100644 |
index 99640cad37073d4f648b37468b752f261a5863a8..0000000000000000000000000000000000000000 |
--- a/tools/testing/browser_README.txt |
+++ /dev/null |
@@ -1,89 +0,0 @@ |
-Overview: |
- These are the instructions to run a wide variety of browser tests using |
- test.dart --component=webdriver or |
- dart/tools/testing/perf_testing/create_graph.py. Currently the results of |
- create_graph are uploaded to https://dartperf.googleplex.com/. |
- |
-============== Windows Setup ============== |
- |
-Open Internet Explorer. Open the Internet Options dialog, and move to the |
-"Security" tab. Click through Internet, Local Intranet, Trusted sites, and |
-Restricted site and ensure the "Enable Protected Mode" is checked for all zones |
-or unchecked for all zones. Then click to the "Advanced" tab, scroll down to the |
-"Security" section, and check the checkbox "Allow active content to run in files |
-on My Computer." |
- |
-================ Mac Setup ================ |
- |
-1) Ensure Java is installed and in your path (if you want to run Safari). If |
- not, install the Java jdk (so that we can run the webdriver server from its |
- jar) |
- |
-2) a) Disable pop-up blocking in Safari: |
- Preferences -> Security -> (unselect) Block pop-up windows. |
- b) copy the file in /Library/Preferences/com.apple.Safari.plist to |
- $DARTDIR/tools/testing/com.apple.Safari.plist |
- (We do this because Safari deletes our preferences (on no pop-up |
- blocking) if it crashes (aka times out) two times in a row.) |
- |
-============= All Platforms ================ |
- |
-THE EASISET WAY: |
-1) Ensure Python 2.7 is installed and in your path. |
-2) Download and install Chrome in the default location if you haven't done so |
- already. |
-3) Run the following script as root/administrator while standing in this |
- directory: |
- $> [sudo] python dart/tools/testing/perf_testing/webdriver_test_setup.py |
-4) Profit! |
- |
-Example Run: |
-$> tools/test.py --component=webdriver --report --timeout=20 --mode=release |
---browser=[ff | safari | chrome | ie] |
-[--frog=path/to/frog/executable/like/Release_ia32/dart-sdk/frogc |
---froglib=path/to/frog/lib/like/dart/frog/lib] test_to_run(like "language" or |
-"corelib") |
- |
-(If you don't specify frog and froglib arguments, we default to using frog with |
-the VM.) |
- |
- |
-============================================ |
-Okay, so you're still here? Here's the long version of what that script does if |
-it didn't work for you: |
-a) Install selenium library python bindings |
- (http://pypi.python.org/pypi/selenium) |
- |
-b) Ensure that Firefox is installed in the default location. |
- |
-c) Download the Chrome Driver: http://code.google.com/p/chromium/downloads/list |
- and make sure it is in your path. |
- |
-d) Download the selenium server (version 2.15 or newer) and place it in this |
- directory: |
- http://selenium.googlecode.com/files/selenium-server-standalone-2.15.0.jar |
- |
- |
-========= Proceed further only if you also want to run performance tests.====== |
- |
-10)Download appengine for Python and place it in third_party (http://code.google.com/appengine/downloads.html#Google_App_Engine_SDK_for_Python): |
- "dart/third_party/appengine-python/" |
- |
-11)Install matplotlib http://matplotlib.sourceforge.net/ |
- |
-12)Pull down benchmarks from internal repo (Google only): |
- http://chromegw.corp.google.com/viewvc/dash/trunk/internal/browserBenchmarks/README.txt?view=markup |
- |
-13)TODO(efortuna): Deal with appengine check in! Run |
- '../../../third_party/appengine-python/1.5.4/appcfg.py update appengine/' |
- while standing in dart/tools/testing/perf_tests. |
- |
-14) Run the tests! While standing in dart/tools/testing/perf_testing, run |
- $> python create_graph.py --forever --verbose |
- to run all the tests (browser performance, language correctness in the |
- browser, command line performance, and self-hosted compile time and compiled |
- code size). |
- |
- You can run individual tests by adding the particular option (such as |
- --language) when running create_graph.py. Type "create_graph.py -h" for a |
- full list of the options. |