ensymble

Данный модуль позволяет работать с sis файлами.

Использование

Для linux систем модуль необходмо просто установить в систему.

Для windows необходимо доустановить openssl.exe, а также libssl32.dll, libeay32.dll, и положить эти файлы рядом с ensymble.py

На ПК возможно использование данного модуля из консоли.

>>> $ ensymble.py command options...

Команды

  • altere32 - добавляет права доступа в приложения или библиотеки. (Alter the IDs and capabilities of e32image files (EXEs, DLLs))
  • genuid - генератор uid (Generate a new test-range UID from a name)
  • infoe32- показывает права доступа приложении или библиотек. (Show the IDs and capabilities of e32image files (EXEs, DLLs))
  • mergesis - сливает два sis файла в один. (Merge several SIS packages into one)
  • py2sis - создает sis приложение. (Create a SIS package for a “Python for S60” application)
  • signsis - подписывает приложение (Sign a SIS package)
  • simplesis - создает sis приложение по структуре папок. (Create a SIS package from a directory structure)
  • version - выводит версию библиотеки. (Print Ensymble version)

Также эти команды доступны в интерпретаторе, первым параметром в них необходимо передать строку, она ни на что не влияет, а вторым, список строк с параметрами.

>>> from ensymble.actions import altere32

Общие параметры

Кодировка

–encoding=terminal,filesystem

-e terminal,filesystem

Выводит информацию

–verbose

-v

Справка, помощь

–help

-h

altere32

>>> $ ensymble.py altere32
        [--uid=0x01234567] [--secureid=0x01234567] [--vendorid=0x01234567]
        [--caps=Cap1+Cap2+...] [--encoding=terminal,filesystem] [--verbose]
        --inplace <infile>...

Данная команда добавляет права в Symbian EXEs and DLLs.

  • infile - путь к исходному файлу
  • outfile - путь к результирующему файлу
  • –inplace, -i - путь к папке с файлами
  • –uid=0x01234567, -u 0x01234567 - юид приложения, если не задан то uid не изменится
  • –secureid=0x01234567, -s 0x01234567 - аналогично uid
  • –vendorid=0x01234567б -r 0x01234567 - аналогично uid
  • –caps=Cap1+Cap2+..., -b Cap1+Cap2+..., –caps=0x12345. -b 0x12345 - права доступа
  • –heapsize=min,max, -H min,max - ограничения использования ОЗУ
>>> $ ensymble.py altere32
    --caps=LocalServices+Location+NetworkServices+PowerMgmt+ProtServ+
    ReadUserData+SurroundingsDD+SWEvent+UserEnvironment+WriteUserData+
    ReadDeviceData+TrustedUI+WriteDeviceData
    myextension_orig.pyd myextension.pyd
>>> $ ensymble.py altere32 --caps=0xff1b4 --inplace *.dll
>>> $ ensymble.py altere32 --heapsize=4k,4M myapp_orig.exe myapp.exe

Note

When modifying the UID, the secure ID should be modified accordingly. Modifying UIDs of application EXEs is generally not possible, because applications usually include the UID in program code as well.

genuid

>>> $ ensymble.py genuid
    [--encoding=terminal,filesystem] [--verbose]
    <name>...

Генератор uid для приложений

  • name - название приложения
>>> $ ensymble.py genuid myapplication myextension
myapplication: 0xe0942bea
myextension: 0xe325ed58

infoe32

>>> $ ensymble.py infoe32
    [--encoding=terminal,filesystem] [--verbose]
    <infile>...

Возвращает информацию о Symbian EXEs and DLLs

  • infile - пути к исходным файлам
>>> $ ensymble.py infoe32 myprogram.exe somelibrary.dll
myprogram.exe:
    UID1          0x1000007a
    UID2          0x100039ce
    UID3          0x12345678
    Secure ID     0x12345678
    Vendor ID     0x00000000
    Capabilities  0x0 (NONE)
somelibrary.dll:
    UID1          0x10000079
    UID2          0x00000000
    UID3          0x00000000
    Secure ID     0x00000000
    Vendor ID     0x00000000
    Capabilities  0xff7be (ALL-TCB-DRM-AllFiles)

mergesis

>>> $ ensymble.py mergesis
        [--cert=mycert.cer] [--privkey=mykey.key] [--passphrase=12345]
        [--encoding=terminal,filesystem] [--verbose]
        <infile> [mergefile]... <outfile>

Сливает sis файлы в один sis файл

Note

The “mergesis” command will only work with SIS files that do not already contain other embedded SIS files.

  • infile - путь к базовому sis
  • mergefile - пути к сливаемым файлам
  • outfile - выходной файл
  • –cert=mycert.cer, -a mycert.cer - сертификаты для подписи
  • –privkey=mykey.key, -k mykey.key - ключи для подписи
  • –passphrase=12345, -p 12345 - пароли

Note

Using command line options to give the pass phrase is insecure. Any user of the computer will be able to see command lines of started programs and thus will see the pass phrase in plain view. Instead, standard input should be used (see examples below).

>>>$ ensymble.py mergesis
–cert=mycert.cer –key=mykey.key –passphrase=12345 myapp_v1_0_0.sis PythonForS60_1_3_17_3rdEd_selfsigned.SIS myapp_standalone_v1_0_0.sis
>>> $ echo "12345" | ensymble.py mergesis
    --cert=mycert.cer --key=mykey.key
    basefile.sis addon1.sis addon2.sis
# 12345 пароль сертификата

py2sis

>>> $ ensymble.py py2sis
        [--uid=0x01234567] [--appname=AppName] [--version=1.0.0]
        [--lang=EN,...] [--icon=icon.svg] [--shortcaption="App. Name",...]
        [--caption="Application Name",...] [--drive=C]
        [--textfile=mytext.txt] [--cert=mycert.cer] [--privkey=mykey.key]
        [--passphrase=12345] [--caps=Cap1+Cap2+...]
        [--vendor="Vendor Name",...] [--autostart]
        [--encoding=terminal,filesystem] [--verbose]
        <src> [sisfile]

Собирает sis

  • src - путь к файлу или папке

  • sisfile - выходной файл, если указать папку, то в папку пложится файл с именем приложения и с версией

  • –appname=AppName, -n AppName - название приложения

  • –uid=0x01234567, -u 0x01234567 - uid

  • –version=1.0.0, -r 1.0.0

  • –lang=EN,..., -l EN,...

  • –icon=icon.svg, -i icon.svg

  • –shortcaption=”App. Name”,..., -s “App. Name”,...

  • –caption=”Application Name”,..., -c “Application Name”,...

  • –drive=C, -f C

  • –extrasdir=root, -x root

  • –textfile=mytext_%.txt, -t mytext_%.txt
    • %% - literal %
    • %n - language number (01 - 99)
    • %c - two-character language code in lowercase letters
    • %C - two-character language code in capital letters
    • %l - language name in English, using only lowercase letters
    • %l - language name in English, using mixed case letters
  • –cert=mycert.cer, -a mycert.cer

  • –privkey=mykey.key, -k mykey.key

  • –passphrase=12345, -p 12345

  • –caps=Cap1+Cap2+..., -b Cap1+Cap2+..., –caps=0x12345, -b 0x12345

  • –vendor=Name,..., -d Name,...

  • –autostart, -g

  • –runinstall, -R

  • –heapsize=min,max, -H min,max

>>> $ ensymble.py py2sis myprog.py
>>> $ echo "12345" | ensymble.py py2sis
    --cert mycert.cer --privkey mykey.key
    myprog.py

signsis

>>> ensymble.py signsis
    [--unsign]
    [--cert=mycert.cer] [--privkey=mykey.key] [--passphrase=12345]
    [--execaps=Cap1+Cap2+...] [--dllcaps=Cap1+Cap2+...]
    [--encoding=terminal,filesystem] [--verbose]
    <infile> [outfile]

Подписывает приложения

  • infile
  • outfile
  • –unsign, -u - удаляет сертификат из файла
  • –cert=mycert.cer, -a mycert.cer
  • –privkey=mykey.key, -k mykey.key
  • –passphrase=12345, -p 12345
  • –execaps=Cap1+Cap2+..., -b Cap1+Cap2+..., –execaps=0x12345, -b 0x12345
  • –dllcaps=Cap1+Cap2+..., -d Cap1+Cap2+..., –dllcaps=0x12345, -d 0x12345
>>> $ ensymble.py signsis
    --dllcaps=LocalServices+Location+NetworkServices+PowerMgmt+ProtServ+
    ReadUserData+SurroundingsDD+SWEvent+UserEnvironment+WriteUserData+
    ReadDeviceData+TrustedUI+WriteDeviceData
    --cert=mycert.cer --key=mykey.key --passphrase=12345
    coolextension_nocert.sis coolextension_mycert.sis
>>> $ echo "12345" | ensymble.py signsis
    --dllcaps=0xff1b4 --cert=mycert.cer --key=mykey.key
    coolextension_nocert.sis coolextension_mycert.sis

simplesis

>>> $ ensymble.py simplesis
    [--uid=0x01234567] [--version=1.0.0] [--lang=EN,...]
    [--caption="Package Name",...] [--drive=C] [--textfile=mytext_%C.txt]
    [--cert=mycert.cer] [--privkey=mykey.key] [--passphrase=12345]
    [--vendor="Vendor Name",...] [--encoding=terminal,filesystem]
    [--verbose]
    <srcdir> [sisfile]

Создает sis приложение по структуре папок

  • srcdir

  • sisfile

  • –uid=0x01234567, -u 0x01234567

  • –version=1.0.0, -r 1.0.0

  • –lang=EN,..., -l EN,...

  • –caption=”Application Name”,..., -c “Application Name”,...

  • –drive=C, -f C

  • –textfile=mytext_%C.txt, -t mytext_%C.txt
    • %% - literal %
    • %n - language number (01 - 99)
    • %c - two-character language code in lowercase letters
    • %C - two-character language code in capital letters
    • %l - language name in English, using only lowercase letters
    • %l - language name in English, using mixed case letters
  • –cert=mycert.cer, -a mycert.cer

  • –privkey=mykey.key, -k mykey.key

  • –passphrase=12345, -p 12345

>>> $ ls -R mymodule
mymodule:
resource/sys/
mymodule/resource:
apps/mymodule.py
mymodule/resource/apps:
mymodule.rsc
mymodule/sys:
bin/
mymodule/sys/bin:
_mymodule.pyd
>>> $ ensymble.py simplesis mymodule
>>> $ echo "12345" | ensymble.py py2sis
    --cert mycert.cer --privkey mykey.key
    mymodule

version

>>> $ ensymble.py version