Skip to content

Commit c1014ca

Browse files
committed
added docgen autogeneration api
1 parent b782b08 commit c1014ca

File tree

1 file changed

+53
-23
lines changed

1 file changed

+53
-23
lines changed

README.md

Lines changed: 53 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -150,73 +150,103 @@ const changeIcon = async (iconName) => {
150150

151151
## API
152152

153+
<docgen-index>
154+
155+
* [`isSupported()`](#issupported)
156+
* [`getName()`](#getname)
157+
* [`change(...)`](#change)
158+
* [`reset(...)`](#reset)
159+
* [Interfaces](#interfaces)
160+
161+
</docgen-index>
162+
163+
<docgen-api>
164+
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
165+
153166
### isSupported()
154167

155168
```typescript
156-
isSupported() => Promise<{value: boolean}>
169+
isSupported() => Promise<{ value: boolean; }>
157170
```
158171

159-
Checks to see if using alternate icons is supported on your device.
172+
Checks if changing the app icon is supported. (iOS only)
173+
174+
**Returns:** <code>Promise&lt;{ value: boolean; }&gt;</code>
175+
176+
**Since:** 1.0.0
177+
178+
--------------------
160179

161-
---
162180

163181
### getName()
164182

165183
```typescript
166-
getName(): Promise<{value: string | null}>;
184+
getName() => Promise<{ value: string | null; }>
167185
```
168186

169187
Gets the name of currently set alternate icon. If original icon is set, returns null.
170188

171-
---
189+
**Returns:** <code>Promise&lt;{ value: string | null; }&gt;</code>
190+
191+
**Since:** 1.0.0
192+
193+
--------------------
194+
172195

173196
### change(...)
174197

175198
```typescript
176-
change(options: IconOptions): Promise<void>;
199+
change(options: IconOptions) => Promise<void>
177200
```
178201

179202
Changes app icon to specified alternate.
180203

181204
| Param | Type |
182205
| ------------- | --------------------------------------------------- |
183-
| **`options`** | <code><a href="#IconOptions">IconOptions</a></code> |
206+
| **`options`** | <code><a href="#iconoptions">IconOptions</a></code> |
207+
208+
**Since:** 1.0.0
209+
210+
--------------------
184211

185-
---
186212

187213
### reset(...)
188214

189215
```typescript
190-
reset(options: ResetOptions): Promise<void>;
216+
reset(options: ResetOptions) => Promise<void>
191217
```
192218

193-
Changes app icon to specified alternate.
219+
Reverts app icon to original.
194220

195-
| Param | Type |
196-
| ------------- | --------------------------------------------------- |
197-
| **`options`** | <code><a href="#IconOptions">ResetOptions</a></code> |
221+
| Param | Type |
222+
| ------------- | ----------------------------------------------------- |
223+
| **`options`** | <code><a href="#resetoptions">ResetOptions</a></code> |
224+
225+
**Since:** 1.0.0
226+
227+
--------------------
198228

199-
---
200229

201230
### Interfaces
202231

203232

204233
#### IconOptions
205234

206-
Represents the options passed to `change`.
235+
| Prop | Type | Description | Since |
236+
| -------------------------- | --------------------- | --------------------------------------------------------------------------------- | ----- |
237+
| **`name`** | <code>string</code> | Name of alternate icon to set | |
238+
| **`disable`** | <code>string[]</code> | Name of icons to disable. This is not used for iOS, but required for Android. | 3.1.0 |
239+
| **`suppressNotification`** | <code>boolean</code> | Flag controlling the in app notification which shows after icon is changed. (iOS) | |
207240

208-
| Prop | Type | Description | Since |
209-
| ----------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
210-
| **`name`** | <code>string</code> | Name of alternate icon to set. | 1.0.0 |
211-
| **`suppressNotification`** | <code>boolean</code> | Flag controlling the in app notification which shows after icon is changed. | 1.0.0 |
212241

213242
#### ResetOptions
214243

215-
Represents the options passed to `reset`.
244+
| Prop | Type | Description | Since |
245+
| -------------------------- | --------------------- | --------------------------------------------------------------------------------- | ----- |
246+
| **`suppressNotification`** | <code>boolean</code> | Flag controlling the in app notification which shows after icon is changed (iOS). | |
247+
| **`disable`** | <code>string[]</code> | Name of icons to disable. This is not used for iOS, but required for Android. | 3.1.1 |
216248

217-
| Prop | Type | Description | Since |
218-
| ----------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
219-
| **`suppressNotification`** | <code>boolean</code> | Flag controlling the in app notification which shows after icon is changed. | 1.0.0 |
249+
</docgen-api>
220250

221251
## Contributors ✨
222252

0 commit comments

Comments
 (0)