@overwolf/ow-electron 28.2.5 → 28.3.2-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +121 -121
- package/checksums.json +10 -9
- package/electron-api.json +438 -348
- package/electron.d.ts +66 -104
- package/ow-electron.d.ts +14 -4
- package/package.json +32 -29
package/README.md
CHANGED
|
@@ -1,121 +1,121 @@
|
|
|
1
|
-
# Overwolf Electron
|
|
2
|
-
|
|
3
|
-
We currently have these npm packages:
|
|
4
|
-
|
|
5
|
-
- [@overwolf/ow-electron](https://www.npmjs.com/package/@overwolf/ow-electron) is a package based on the
|
|
6
|
-
[electron package](https://www.npmjs.com/package/electron), which adds a
|
|
7
|
-
few features to it
|
|
8
|
-
- [@overwolf/ow-electron-builder](https://www.npmjs.com/package/@overwolf/ow-electron-builder) is a packaged based on electron-builder which
|
|
9
|
-
supports building ow-electron
|
|
10
|
-
-
|
|
11
|
-
[electron-is-dev](https://www.npmjs.com/package/electron-is-dev)
|
|
12
|
-
|
|
13
|
-
There is no problem that both packages reside side-by-side with the original
|
|
14
|
-
electron/electron-builder packages in your project. You just have to create new
|
|
15
|
-
package.json scripts:
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
"scripts": {
|
|
19
|
-
...
|
|
20
|
-
|
|
21
|
-
"start": "ow-electron .",
|
|
22
|
-
"build:ow-electron": "ow-electron-builder --publish=never"
|
|
23
|
-
},
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## package.json properties
|
|
27
|
-
|
|
28
|
-
Each ow-electron app should have a unique id. The unique id is auto-generated
|
|
29
|
-
based on the <productName/name + author.name> fields of the package.json.
|
|
30
|
-
|
|
31
|
-
We use this for ad optimization and optionally, for
|
|
32
|
-
[anonymous analytics](#anonymous-analytics) reports that you may review on our developer's console.
|
|
33
|
-
|
|
34
|
-
> **NOTE:** To see the generated uid - you can use the OVERWOLF_APP_UID
|
|
35
|
-
> environment variable (process.env.OVERWOLF_APP_UID) once the |app.whenReady|
|
|
36
|
-
> triggers. Before the app is ready, the variable won't exist.
|
|
37
|
-
|
|
38
|
-
## owadview tag
|
|
39
|
-
|
|
40
|
-
> **NOTE:** In order to see ads, we first have to setup our backend to support
|
|
41
|
-
> your app's uid (See package.json properties above).
|
|
42
|
-
> Please contact us for further info on this
|
|
43
|
-
> [contact us](https://overwolf.github.io/support/contact-us)
|
|
44
|
-
|
|
45
|
-
The ```<owadview/>``` tag, which is based on the Electron <webview/> tag, hosts and
|
|
46
|
-
auto manages ads in your app.
|
|
47
|
-
|
|
48
|
-
To use it, place the ```<owadview/>``` tag (no attributes required) inside a ```<div>``` tag
|
|
49
|
-
which has the size of the standard IAB ad unit you wish to display.
|
|
50
|
-
|
|
51
|
-
See https://overwolf.github.io/start/monetize-with-ads/ads-monetization-basics
|
|
52
|
-
for some more information about supported ad units + Dos’ and ‘Dont’s. This
|
|
53
|
-
documentation is aimed at the Overwolf platform, however, the general ad
|
|
54
|
-
details are relevant for the ow-electron build as well.
|
|
55
|
-
|
|
56
|
-
```
|
|
57
|
-
<div style="width: 400px;height: 300px; background: transparent;">
|
|
58
|
-
<owadview />
|
|
59
|
-
</div>
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
> **NOTE:** We use background: transparent so that you can show a background
|
|
63
|
-
> image as a fallback when there are no ads inventory to display.
|
|
64
|
-
|
|
65
|
-
A few extra things to know:
|
|
66
|
-
|
|
67
|
-
- The ```<owadview/>``` starts auto-muted. This can be changed, see
|
|
68
|
-
https://www.electronjs.org/docs/latest/api/webview-tag#webviewsetaudiomutedmuted
|
|
69
|
-
- The tag is self managed so there is no need to worry about visiblity of ads
|
|
70
|
-
or crashes
|
|
71
|
-
|
|
72
|
-
## Anonymous Analytics
|
|
73
|
-
|
|
74
|
-
In order to generate some reports for you about the usage of your ow-electron
|
|
75
|
-
app, we collect very few anonymous analytics (such as when the app is launched
|
|
76
|
-
and when an app's window is shown).
|
|
77
|
-
|
|
78
|
-
You can disable this via code:
|
|
79
|
-
|
|
80
|
-
```
|
|
81
|
-
import { app } from 'electron';
|
|
82
|
-
|
|
83
|
-
app.overwolf.disableAnonymousAnalytics();
|
|
84
|
-
|
|
85
|
-
...
|
|
86
|
-
|
|
87
|
-
app.whenReady().then(...
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
> **NOTE:** This call isn't persistent across sessions - it needs to be called
|
|
91
|
-
> every time the app is launched.
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
## Consent Management Platform (CMP)
|
|
95
|
-
|
|
96
|
-
CMP makes it easier for you to meet the technical requirements of the law by simplifying the legally required process of collecting consent to cookies.
|
|
97
|
-
|
|
98
|
-
Before using your app, the user should be informed about the existence of the CMP and be able to easily access it.
|
|
99
|
-
|
|
100
|
-
We recommend showing this information during the installation phase or as a first-time usage message.
|
|
101
|
-
|
|
102
|
-
The ow-electron comes with a CMP implementation built in.
|
|
103
|
-
|
|
104
|
-
> **NOTE:** You can leverage our Windows Installer for this (contact us).
|
|
105
|
-
|
|
106
|
-
In order to know if the user is required to be informed about the CMP - use the |app.overwolf.isCMPRequired| api:
|
|
107
|
-
|
|
108
|
-
```
|
|
109
|
-
import { app } from 'electron';
|
|
110
|
-
|
|
111
|
-
await app.overwolf.isCMPRequired();
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
In order to open the built-in CMP window - use the |app.overwolf.openCMPWindow| api:
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
```
|
|
118
|
-
app.overwolf.openCMPWindow();
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
|
|
1
|
+
# Overwolf Electron
|
|
2
|
+
|
|
3
|
+
We currently have these npm packages:
|
|
4
|
+
|
|
5
|
+
- [@overwolf/ow-electron](https://www.npmjs.com/package/@overwolf/ow-electron) is a package based on the
|
|
6
|
+
[electron package](https://www.npmjs.com/package/electron), which adds a
|
|
7
|
+
few features to it
|
|
8
|
+
- [@overwolf/ow-electron-builder](https://www.npmjs.com/package/@overwolf/ow-electron-builder) is a packaged based on electron-builder which
|
|
9
|
+
supports building ow-electron
|
|
10
|
+
- @overwolf/electron-is-overwolf - similar to
|
|
11
|
+
[electron-is-dev](https://www.npmjs.com/package/electron-is-dev)
|
|
12
|
+
|
|
13
|
+
There is no problem that both packages reside side-by-side with the original
|
|
14
|
+
electron/electron-builder packages in your project. You just have to create new
|
|
15
|
+
package.json scripts:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
"scripts": {
|
|
19
|
+
...
|
|
20
|
+
|
|
21
|
+
"start": "ow-electron .",
|
|
22
|
+
"build:ow-electron": "ow-electron-builder --publish=never"
|
|
23
|
+
},
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## package.json properties
|
|
27
|
+
|
|
28
|
+
Each ow-electron app should have a unique id. The unique id is auto-generated
|
|
29
|
+
based on the <productName/name + author.name> fields of the package.json.
|
|
30
|
+
|
|
31
|
+
We use this for ad optimization and optionally, for
|
|
32
|
+
[anonymous analytics](#anonymous-analytics) reports that you may review on our developer's console.
|
|
33
|
+
|
|
34
|
+
> **NOTE:** To see the generated uid - you can use the OVERWOLF_APP_UID
|
|
35
|
+
> environment variable (process.env.OVERWOLF_APP_UID) once the |app.whenReady|
|
|
36
|
+
> triggers. Before the app is ready, the variable won't exist.
|
|
37
|
+
|
|
38
|
+
## owadview tag
|
|
39
|
+
|
|
40
|
+
> **NOTE:** In order to see ads, we first have to setup our backend to support
|
|
41
|
+
> your app's uid (See package.json properties above).
|
|
42
|
+
> Please contact us for further info on this
|
|
43
|
+
> [contact us](https://overwolf.github.io/support/contact-us)
|
|
44
|
+
|
|
45
|
+
The ```<owadview/>``` tag, which is based on the Electron <webview/> tag, hosts and
|
|
46
|
+
auto manages ads in your app.
|
|
47
|
+
|
|
48
|
+
To use it, place the ```<owadview/>``` tag (no attributes required) inside a ```<div>``` tag
|
|
49
|
+
which has the size of the standard IAB ad unit you wish to display.
|
|
50
|
+
|
|
51
|
+
See https://overwolf.github.io/start/monetize-with-ads/ads-monetization-basics
|
|
52
|
+
for some more information about supported ad units + Dos’ and ‘Dont’s. This
|
|
53
|
+
documentation is aimed at the Overwolf platform, however, the general ad
|
|
54
|
+
details are relevant for the ow-electron build as well.
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
<div style="width: 400px;height: 300px; background: transparent;">
|
|
58
|
+
<owadview />
|
|
59
|
+
</div>
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
> **NOTE:** We use background: transparent so that you can show a background
|
|
63
|
+
> image as a fallback when there are no ads inventory to display.
|
|
64
|
+
|
|
65
|
+
A few extra things to know:
|
|
66
|
+
|
|
67
|
+
- The ```<owadview/>``` starts auto-muted. This can be changed, see
|
|
68
|
+
https://www.electronjs.org/docs/latest/api/webview-tag#webviewsetaudiomutedmuted
|
|
69
|
+
- The tag is self managed so there is no need to worry about visiblity of ads
|
|
70
|
+
or crashes
|
|
71
|
+
|
|
72
|
+
## Anonymous Analytics
|
|
73
|
+
|
|
74
|
+
In order to generate some reports for you about the usage of your ow-electron
|
|
75
|
+
app, we collect very few anonymous analytics (such as when the app is launched
|
|
76
|
+
and when an app's window is shown).
|
|
77
|
+
|
|
78
|
+
You can disable this via code:
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
import { app } from 'electron';
|
|
82
|
+
|
|
83
|
+
app.overwolf.disableAnonymousAnalytics();
|
|
84
|
+
|
|
85
|
+
...
|
|
86
|
+
|
|
87
|
+
app.whenReady().then(...
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
> **NOTE:** This call isn't persistent across sessions - it needs to be called
|
|
91
|
+
> every time the app is launched.
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
## Consent Management Platform (CMP)
|
|
95
|
+
|
|
96
|
+
CMP makes it easier for you to meet the technical requirements of the law by simplifying the legally required process of collecting consent to cookies.
|
|
97
|
+
|
|
98
|
+
Before using your app, the user should be informed about the existence of the CMP and be able to easily access it.
|
|
99
|
+
|
|
100
|
+
We recommend showing this information during the installation phase or as a first-time usage message.
|
|
101
|
+
|
|
102
|
+
The ow-electron comes with a CMP implementation built in.
|
|
103
|
+
|
|
104
|
+
> **NOTE:** You can leverage our Windows Installer for this (contact us).
|
|
105
|
+
|
|
106
|
+
In order to know if the user is required to be informed about the CMP - use the |app.overwolf.isCMPRequired| api:
|
|
107
|
+
|
|
108
|
+
```
|
|
109
|
+
import { app } from 'electron';
|
|
110
|
+
|
|
111
|
+
await app.overwolf.isCMPRequired();
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
In order to open the built-in CMP window - use the |app.overwolf.openCMPWindow| api:
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
```
|
|
118
|
+
app.overwolf.openCMPWindow();
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
|
package/checksums.json
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
{
|
|
2
|
-
"electron-api.json": "a6e536d48e399f0961cb5de1e9cb0d3e534c4686fdf6fc79080e66516fdd5b6e",
|
|
3
|
-
"ow-electron-v28.2.
|
|
4
|
-
"ow-electron-v28.2.
|
|
5
|
-
"ow-electron-v28.2.
|
|
6
|
-
"ow-electron-v28.2.
|
|
7
|
-
"ow-electron-v28.2.
|
|
8
|
-
"ow-electron-v28.2.
|
|
9
|
-
"electron.
|
|
1
|
+
{
|
|
2
|
+
"electron-api.json": "a6e536d48e399f0961cb5de1e9cb0d3e534c4686fdf6fc79080e66516fdd5b6e",
|
|
3
|
+
"ow-electron-v28.3.2-beta.2-darwin-arm64.zip": "ed4fa258361d35303d0e640a33c8ef369855e397fae51cc9794f27ef512e2083",
|
|
4
|
+
"ow-electron-v28.3.2-beta.2-darwin-x64.zip": "2b574ff3b26a1dee5fa9c9e570a6903b0cfaa87884a49d712387f89faa8447d6",
|
|
5
|
+
"ow-electron-v28.3.2-beta.2-win32-x64.zip": "b26948762639789f86153ab395dd06c2aec2eed74b2e1e581fcc622a6fea1d0b",
|
|
6
|
+
"ow-electron-v28.3.2-beta.2-win32-ia32.zip": "9d016b77e7034a236776208da5329a7ff21dc8a8eaf059722fade46ec69b4d64",
|
|
7
|
+
"ow-electron-v28.3.2-beta.2-linux-x64.zip": "20f6be493cbd6c9924206e744b1c490af1f97f4735451b9dc19f0d305366d546",
|
|
8
|
+
"ow-electron-v28.3.2-beta.2-linux-arm64.zip": "f77107266581a6b9880757876518df1c4bf6eeff5c193bb5de0a8f6c9902bd1f",
|
|
9
|
+
"ow-electron-v28.3.2-beta.2-linux-armv7l.zip": "384d8b43f52b5350a438031ad12980418fc244b4b0aecfa5f7dcc3d6f103ebed",
|
|
10
|
+
"electron.d.ts": "6076bfc6a433a8df4603443f4e984210913d20e5c78526cd3a1a1ddc78e47cb2"
|
|
10
11
|
}
|