Skip to main content

GitVerse

GitVerse — is a Russian platform for working with source code. GitVerse allows to create and develop projects in private and public repositories, automatically build these projects and publish them in RuStore.

caution

You have to upload the first version of your app manually in the RuStore Console — later versions can be published directly from GitVerse.

In the RuStore Console, GitVerse is available on tab Tools > your app > GitVerse in the left menu. This will open a page that contains the relevant description and a link to the required tool.

img
  • Simple publication. This integration allows seamless app publishing from GitVerse to RuStore. This means that you don't have to upload your files to the RuStore Console.

Integration configuration​

For integration, use your project template and a RuStore API script. This script allows to retrieve a token, create a draft, send a new app version to RuStore, and delete draft.

To set up an integration you'll need:

  • A private RuStore API key and ID of this private key. You can view them in the RuStore Console > either Company or Developer > API RuStore tab. If you don't have a key, generate a key pair.
  • Your app's metadata (for example: className).

To set up GitVerse integration with RuStore:

  1. Register at GitVerse and create an organization. Organization is a logical unit inside GitVerse that is used to manage projects.

  2. Create a repository and activate the CI/CD switch in the settings. In the repository menu, a new tab will appear: CI/CD.

  3. Register a GitVerse CI/CD agent GitVerse CI/CD to build and send your app to RuStore. You can create one in Linux, WSL (Windows), or any other cloud. For example, in WSL (Ubuntu) and virtual machine Cloud.ru.

  4. Declare the following variables in the CI/CD section or use them inside your code, as it is done in the template:

    • PRIVATE_KEY— app private key from the RuStore Console;
    • KEY_ID — private key ID from the RuStore Console.
    note

    The project template is located at evangelism/rustore. It is for test purposes, that's why we recommend you to avoid storing passwords, IDs and other sensitive data in plain text.

    The template uses the RuStore token generator in .jar, however, you can use any method of your choice fr generation.

  5. To start using your test project, execute git clone https://gitverse.ru/evangelism/rustore, configure runners, and specify your configuration values.

What next​

Before sending a new app version to RuStore, please, specify its attributes in the rustore.sh file. The attributes are described in section Create draft version.

Having done that, build your app and upload app version to RuStore.

caution

If app settings are modified, also modify them in the RuStore Console. If you don't do this, CI/CD will generate an error due to incompatibility of the permissions in the local version and permissions of the version sent with the app package.

For example, if an app has new permissions, add them to the RuStore Console before sending a new version with GitVerse.