UNPKG

terriajs

Version:

Geospatial data visualization platform.

github.com/TerriaJS/terriajs

TerriaJS/terriajs

94 lines (56 loc) • 2.81 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
### Problem TerriaJS app is accessible at `http://localhost:3001` but it does not render a map. ![Map not rendered](./img/no-map.png) ### Workaround The default TerriaJS configuration uses Cesium Ion for serving some of its basemaps. If the Cesium Ion access token has expired then these basemaps will fail to render. We recommend that you [register](https://cesium.com/ion/signup/) and use your own Cesium Ion access token. Please see the documentation on [client side configuration](../customizing/client-side-config.md#parameters) for configuring your access token. Also note that it is a violation of the Ion terms-of-use to use the default key in a deployed application. --- ### Problem Building TerriaMap (without yarn workspaces) throws an error like: ``` You have two copies of terriajs-cesium ``` ### Solution Check: ``` yarn list terriajs-cesium ``` If there are 2 different versions listed, run: ``` yarn gulp sync-terriajs-dependencies ``` If there's only 1 version listed in 2 places your yarn lockfile is playing up. To fix it, you could use [yarn-deduplicate](https://www.npmjs.com/package/yarn-deduplicate) or try reverting to a known good commit of your lockfile, and then run `yarn install` again. --- ### Problem When using yarn workspaces to develop a TerriaMap against a custom version of terriajs `yarn install` throws error ``` An unexpected error occurred: "expected workspace package to exist for \"pkg-dir\"" ``` or a similar error with a different package. Sometimes yarn versions after yarn@1.19.0 will cause an error when running yarn install using workspaces. The Github issue describing it https://github.com/yarnpkg/yarn/issues/7807 has comments saying it’s caused by a workspace trying to install a different version of the same dependency. ### Workaround Easiest fix is to install dependencies using an older version of yarn: ``` npx yarn@1.19.0 install ``` It’s possible the problem could also be fixed in certain cases by syncing dependency versions for the same package, and ensuring that a workspace doesn’t install the same dependency but with a different version. Syncing dependencies could help: ``` yarn gulp sync-terriajs-dependencies ``` --- ### Problem I have already have NodeJS installed, but I need an early version for TerriaJS ### Solution You can use [nvm](https://github.com/nvm-sh/nvm#installing-and-updating) to manage multiple versions of NodeJS. Follow installation instructions [here](https://github.com/nvm-sh/nvm#installing-and-updating). Then run the following to install NodeJS v16 and use it: ```bash nvm install 16 nvm use 16 ``` ### Problem When building TerriaMap/TerriaJS I see the following error ``` Error: error:0308010C:digital envelope routines::unsupported ``` ### Solution Update to TerriaJS 8.4.1.