OLD | NEW |
| 1 This package contains dart.js, and previously contained interop.js |
| 2 |
| 3 dart.js |
| 4 ======= |
| 5 |
1 The dart.js file is used in Dart browser apps to check for native Dart support | 6 The dart.js file is used in Dart browser apps to check for native Dart support |
2 and either (a) bootstrap Dartium or (b) load compiled JS instead. Previously, | 7 and either (a) bootstrap Dartium or (b) load compiled JS instead. Previously, |
3 we've recommended that you add a script tag pointing the version of dart.js in | 8 we've recommended that you add a script tag pointing the version of dart.js in |
4 our repository. This doesn't work offline and also results in slower startup | 9 our repository. This doesn't work offline and also results in slower startup |
5 (see [dartbug.com/6723](http://dartbug.com/6723)). | 10 (see [dartbug.com/6723](http://dartbug.com/6723)). |
6 | 11 |
7 Instead, we now recommend that you install dart.js via the following steps: | 12 Instead, we now recommend that you install dart.js via the following steps: |
8 | 13 |
9 1. Add the following to your pubspec.yaml: | 14 1. Add the following to your pubspec.yaml: |
10 dependencies: | 15 dependencies: |
11 browser: any | 16 browser: any |
12 | 17 |
13 2. Run pub install. | 18 2. Run pub install. |
14 | 19 |
15 3. Use a relative script tag in your html to the installed version: | 20 3. Use a relative script tag in your html to the installed version: |
16 | 21 |
17 `<script src="packages/browser/dart.js"></script>` | 22 `<script src="packages/browser/dart.js"></script>` |
18 | 23 |
19 If you do not wish to use pub, you may host a copy of this file locally instead. | 24 If you do not wish to use pub, you may host a copy of this file locally instead. |
20 In this case, you will need to update it yourself as necessary. We reserve the | 25 In this case, you will need to update it yourself as necessary. We reserve the |
21 right to move the old file in the repository, so we no longer recommend linking | 26 right to move the old file in the repository, so we no longer recommend linking |
22 to it directly. | 27 to it directly. |
| 28 |
| 29 interop.js |
| 30 ========== |
| 31 |
| 32 This script was required for dart:js interop to work, but it is no longer |
| 33 needed. The functionality is now supported by dart:js directly. |
| 34 |
| 35 If you previously had a script such as this, please remove it: |
| 36 |
| 37 ```html |
| 38 <script src="packages/browser/interop.js"></script> |
| 39 ``` |
OLD | NEW |