OneScript Package Registry

To work with 1C packages, you need the OneScript utility and the opm package manager.

Windows

Download the installer from the official website https://oscript.io/downloads and run it. Follow the on-screen installation prompts.

Linux

Download the required package from the official website https://oscript.io/downloads and install it:

sudo dpkg --install onescript-engine_1.9.1_all.deb

macOS

There is no interactive installer, but the engine can be installed from the command line:

Install Homebrew.
Install Mono:
```
brew install mono  
```
Download ovm.
Run:
```
mono ovm.exe install stable  
```
Run:
```
mono ovm.exe use stable  
```
Restart the terminal.

Additional Configuration for Self-Contained Deployment (No .NET Installation Required)

chmod +x ./oscript  
xattr -d com.apple.quarantine *.dylib oscript  
codesign -s - ./oscript

Updating

After installing OneScript, update the package manager for proper functionality:

opm update opm

Registering the GitFlic Registry

To add OneScript packages, you need a GitFlic transport token. For instructions on obtaining the token, refer to this page.

In the documentation below, replace <gitflic_domain> with the appropriate domain, depending on the version:

For SaaS: registry.gitflic.ru
For self-hosted: localhost:8080

The domain and port for self-hosted versions may vary.

The url attribute value depends on the access level:

Level	URL
Project	`/project/{ownerAlias}/{projectAlias}/package/-/opm/`
Company	`/company/{companyAlias}/package/-/opm/`
Instance	`/package/-/opm/`

URL Variable	Description
`ownerAlias`	Project owner's alias
`projectAlias`	Project alias
`companyAlias`	Company alias

Configuration is done by creating a service file opm.cfg. This configuration file can be placed in the following paths (listed in descending order of priority):

./opm.cfg - Current launch directory + /opm.cfg
User settings directory:
Linux: ~/.opm.cfg (Note: The file must start with a dot .opm.cfg)
Windows: %USERPROFILE%\opm.cfg
System settings:
Linux: /etc/opm.cfg
Windows: C:\ProgramData\opm.cfg
OSCRIPT/lib/opm/opm.cfg - OPM installation directory (for compatibility).

Configuration File Template

{  
    "СервераПакетов": [  
        {  
            "Имя": "СерверУдаленногоХранилища",  
            "Сервер": "<gitflic_domain>",  
            "Порт": 8080,  
            "Авторизация": "OAUTH_TOKEN <transport_token>",  
            "ПутьНаСервере": "<selected_url>",  
            "РесурсПубликацииПакетов": "<selected_url>"  
        }  
    ]  
}

Downloading and Installing a Package

To install a package, run:

opm install <package_name>

Publishing a Package

To publish a package, run:

opm push --channel stable <path_to_file>

Automatic translation!

This page has been automatically translated. The text may contain inaccuracies.