Skip to content

Commit

Permalink
Change plugin params descriptions into README
Browse files Browse the repository at this point in the history
  • Loading branch information
cosic committed Dec 23, 2023
1 parent edf4d19 commit d302f57
Show file tree
Hide file tree
Showing 4 changed files with 47 additions and 19 deletions.
66 changes: 47 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
# RuStore Publishing

[comment]: # (Markdown formating https://docs.github.com/ru/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)

<p align="center">
<img src="docs/screenshots/logo.png" width="400">
</p>

<h1 align="center">
RuStore Publishing
</h1>

![Version](https://img.shields.io/badge/GradlePortal-0.3.1-green.svg)
![Version](https://img.shields.io/badge/Gradle-8.*-pink.svg)
Expand All @@ -16,7 +25,7 @@ For publication the plugin used [Rustore API](https://help.rustore.ru/rustore/fo
- [Using the Gradle plugin DSL](#using-the-gradle-plugin-dsl)
- [Using the `apply` method](#using-the-apply-method)
- [Configuring Plugin](#configuring-plugin)
- [Plugin params](#plugin-params)
- [Configuration params](#configuration-params)
- [Plugin usage](#plugin-usage)

<!-- /TOC -->
Expand Down Expand Up @@ -159,33 +168,49 @@ File `rustore-credentials.json` contains next json structure:
```
How to get credentials see [[RU] Rustore API Getting Started](https://help.rustore.ru/rustore/for_developers/work_with_RuStore_API/authorization_rustore_api_1).

## Plugin params
Where Priority(P), Required(R), Optional(O)
## Configuration params

| param | P | type | default value | cli | description |
|--------------------|---|-------------------|---------------|------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `credentialsPath` | O | string | null | `--credentialsPath` | Path to json file with AppGallery credentials params (`company_id` and `client_secret`) |
| `buildFile` | O | string | null | `--buildFile` | Path to build file. "null" means use standard path for "apk" and "aab" files. |
| `releaseNotes` | O | List<ReleaseNote> | null | `--releaseNotes` (see ReleaseNote param desc.) | Release Notes. For mote info see documentation below. |
### Base level params

other params
##### `credentialsPath`
* **Description**: Path to json file with RuStore credentials params (`company_id` and `client_secret`)
* **Type**: String (Optional), **Default** value: `null`
* **CLI**: `--credentialsPath`

| ReleaseNote(Object) | P | type | default value | cli | description |
|----------------------|---|---------|---------------|--------------------------------|-----------------------------------------------------------------------------------------------------------------------|
| `lang` | R | string | null | (See `--releaseNotes` desc.) | Support only `ru-RU` lang. |
| `filePath` | R | string | null | (See `--releaseNotes` desc.) | Absolutely path to file with Release Notes for current `lang`. Release notes text must be less or equals to 500 sign. |
##### `buildFile`
* **Description**: Path to build file. "null" means use standard path for "apk" and "aab" files.
* **Type**: String (Optional), **Default** value: `null`
* **CLI**: `--buildFile`

For CLI `--releaseNotes` use string type with format: `<lang>:<releaseNotes_FilePath>`.
### ReleaseNotes

<details>
<summary>For example</summary>
##### `descriptions`
* **Description**: Release Notes by languages. For mote info see documentation below.
* **Type**: List<ReleaseNote> (Required), **Default** value: `null`
* **CLI**: (See `--releaseNotes` desc.)

##### `releaseNotes`
* **Description**: Release Notes settings. For mote info see ReleaseNote param desc.
* **Type**: List<ReleaseNote> (Optional), **Default** value: `null`
* **CLI**: (see ReleaseNotes param desc.)

### ReleaseNote

##### `lang`
* **Description**: Support only `ru-RU` lang.
* **Type**: String (Required), **Default** value: `null`
* **CLI**: (See `--releaseNotes` desc.)

##### `filePath`
* **Description**: Absolutely path to file with Release Notes for current `lang`. Release notes text must be less or equals to 500 sign.
* **Type**: String (Required), **Default** value: `null`
* **CLI**: (See `--releaseNotes` desc.)

For CLI `--releaseNotes` use string type with format: `<lang>:<releaseNotes_FilePath>`. For example:
```bash
--releaseNotes="ru_RU:/home/<USERNAME>/str/project/release_notes_ru.txt"
```

</details>

# Plugin usage

Gradle generate `publishRustore*` task for all buildType and flavor configurations
Expand Down Expand Up @@ -214,6 +239,9 @@ You can apply or override each plugin extension parameter dynamically by using C
./gradlew assembleRelease publishRustoreRelease \
--credentialsPath="/sample1/rustore-credentials.json"
```
# Promotion

Also consider our [Gradle Plugin for publishing to Huawei AppGallery] (https://github.com/cianru/huawei-appgallery-publish-gradle-plugin)

# License

Expand Down
Binary file added docs/screenshots/cian_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/rustore_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit d302f57

Please sign in to comment.