PyS60 Standalone Applications (Python on Symbian)

Original Author:

PythonForS60_1.9.6_Setup.exe
Python 2.5.x
\PythonForS60\ensymble_gui.py
default.py
.py
 PythonForS60\README
lang
shortcaption
caption
vendor
textfile
hidden
launch
mergesis
default.py
default.py
mp3
mergesis
makesis
signsis
AllFiles
\private\application-specific-UID\
AllFiles
\Epoc32\tools\dumpsis.exe
dumpsis filename.sis
cap
--lang=EN,FR,GE

lang
--caption="English Caption","French Caption","German Caption"

lang
--shortcaption="EngCapt","FncCapt","GmCpt"

lang
--vendor="BigCorp","French Big Corp","German Big Corp"

--textfile=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

 
# -*- coding: utf-8 -*-
 
__all__ = [ "Locale" ]
 
class Loc_Data(object):
    "Translation data holder"
    pass
 
class Default(object):
    "Default language support"
    def __init__(self):
        self.loc = Loc_Data()
        self.loc.zero = u'Zero'
        self.loc.one = u'One'
        self.loc.two = u'Two'
        self.loc.three = u'Three'
        self.loc.four = u'Four'
        self.loc.five = u'Five'
        self.loc.six = u'Six'
        self.loc.seven = u'Seven'
        self.loc.eight = u'Eight'
        self.loc.nine = u'Nine'
        self.loc.change_language = u'Change Language'
        self.loc.english_us = u'English (USA)'
        self.loc.finnish = u'Finnish'
        self.loc.hungarian = u'Hungarian'
        self.loc.portuguese_br = u'Portuguese (Brazil)'
        self.loc.about = u'About'
        self.loc.exit = u'Exit'
 
class Locale(Default):
    "Multiple language support class"
 
    LOC_MODULE = "wm_locale_%s"
 
    def __init__(self,lang = ""):
        "Load all locale strings for one specific language or default if empty"        
        self.set_locale(lang)
 
    def set_locale(self,lang = ""):
        "Load all locale strings for one specific language or default if empty"
        Default.__init__(self)
 
        try:
            lang_mod = __import__( self.LOC_MODULE % ( lang ) )
        except ImportError:
            pass
        else:
            self.merge_locale(lang_mod)
 
    def merge_locale(self, lang_mod):
        "Merge new location string into default locale"
 
        # replace existing strings and keep old ones
        # if it is missing in the locale module
        for k,v in self.loc.__dict__.iteritems():
            if hasattr(lang_mod,k):
                nv = lang_mod.__getattribute__(k)
                self.loc.__setattr__(k,nv)  
 
 
LOC_MODULE = "wm_locale_%s"
 
 
# -*- coding: utf-8 -*-
zero = u'Zero'
one = u'Um'
two = u'Dois'
three = u'Três'
four = u'Quatro'
five = u'Cinco'
six = u'Seis'
seven = u'Sete'
eight = u'Oito'
nine = u'Nove'
change_language = u'Mudar idioma'
english_us = u'Inglês (EUA)'
finnish = u'Finlandês'
hungarian = u'Húngaro'
portuguese_br = u'Português (Brasil)'
about = u'Sobre'
exit = u'Sair'
 
 
# -*- coding: utf-8 -*-
import sys
sys.path.append(r'e:\python')
 
import appuifw
import e32
import wm_locale
 
class Locale_Demo(object):
    def __init__(self):
        appuifw.app.exit_key_handler = self.close
        appuifw.app.title = u"Locale Demo"
        self.update_locale()
        self.app_lock = e32.Ao_lock()
 
    def close(self):
        self.app_lock.signal()
 
    def about(self):
        appuifw.note( u"Locale Demo", "info" )
 
    def update_locale(self,lang=""):
        self.labels = wm_locale.Locale(lang)
        self.refresh()
 
    def refresh(self):
        entries = [
            self.labels.loc.zero,
            self.labels.loc.one,
            self.labels.loc.two,
            self.labels.loc.three,
            self.labels.loc.four,
            self.labels.loc.five,
            self.labels.loc.six,
            self.labels.loc.seven,
            self.labels.loc.eight,
            self.labels.loc.nine
            ]
 
        self.body = appuifw.Listbox(entries)
 
        self.menu = [
            (self.labels.loc.change_language, (
                (self.labels.loc.english_us, lambda: self.update_locale("en_US")),
                (self.labels.loc.finnish, lambda: self.update_locale("fi")),
                (self.labels.loc.hungarian, lambda: self.update_locale("hu")),
                (self.labels.loc.portuguese_br, lambda: self.update_locale("pt_BR"))
                )
             ),
            (self.labels.loc.about, self.about),
            (self.labels.loc.exit, self.close)
            ]
 
        appuifw.app.menu = self.menu
        appuifw.app.body = self.body
 
    def run(self):
        self.app_lock.wait()
        appuifw.app.menu = []
        appuifw.app.body = None
        appuifw.app.set_exit()
 
if __name__ == "__main__":
 
    ld = Locale_Demo()
    ld.run()
 
 
zero = u'Zero'
one = u'One'
two = u'Two'
three = u'Three'
four = u'Four'
five = u'Five'
six = u'Six'
seven = u'Seven'
eight = u'Eight'
nine = u'Nine'
change_language = u'Change Language'
english_us = u'English (USA)'
finnish = u'Finnish'
hungarian = u'Hungarian'
portuguese_br = u'Portuguese (Brazil)'
about = u'About'
exit = u'Exit'
 
 
zero = u'nolla'
one = u'yksi'
two = u'kaksi'
three = u'kolme'
four = u'neljä'
five = u'viisi'
six = u'kuusi'
seven = u'seitsemän'
eight = u'kahdeksan'
nine = u'yhdeksän'
change_language = u'Vaihda kieli'
english_us = u'englanti'
finnish = u'suomi'
hungarian = u'unkari'
about = u'Tietoja'
exit = u'Poistu'
 
 
zero = u'nulla'
one = u'egy'
two = u'kett\u0151'
three = u'három'
four = u'négy'
five = u'öt'
six = u'hat'
seven = u'hét'
eight = u'nyolc'
nine = u'kilenc'
change_language = u'Nyelv változtatás'
english_us = u'angol'
finnish = u'finn'
hungarian = u'magyar'
about = u'Információ'
exit = u'Kijárat'
 
 
import appuifw
import e32
import os
import sysinfo
 
pathtoapp=os.path.dirname(appuifw.app.full_name())
 
is_registered=0
 
timer = e32.Ao_timer()
app_lock = e32.Ao_lock()
 
phone_imei=sysinfo.imei()
reg_code = phone_imei[2]+phone_imei[0]+phone_imei[0]+phone_imei[8]
 
 
def write_settings():
# Write registration flag
    global is_registered   
    REG_DIR='C:\\system\\data\\registration'
    CONFIG_FILE=os.path.join(REG_DIR,'confg.set')
    if not os.path.isdir(REG_DIR):
        os.makedirs(REG_DIR)
        REG_FILE=os.path.join(REG_DIR,'confg.set')      
    config={}
    config['is_registered']= is_registered
    f=open(REG_FILE,'wt')
    f.write(repr(config))
    f.close()
 
def read_settings():
# Read registration flag
    global is_registered   
    REG_FILE='C:\\system\\data\\registration\\confg.set'
    print "read settings 2"
    try:
	print "read settings 3"
        f=open(REG_FILE,'rt')
        try:
            content = f.read()
            config=eval(content)
            f.close()
            is_registered=config.get('is_registered','')
        except:
            appuifw.note(u"Cannot read settings file", "error")
    except:
	print "read settings 4"
        appuifw.note(u"Creating settings file", "info")
 
def exit_key_handler():
    write_settings()
    appuifw.app.set_exit()
 
 
def quit():
    write_settings()
    appuifw.app.set_exit()
 
L_Unregistered = [u"Register",u"About", u"Exit"]
 
L_Registered = [u"About", u"Exit"]
 
def start_application():
# On start check if the application is registered or not and accordingly give menu pop-up  
options
    global is_registered
    if is_registered == 0:
	appuifw.app.title = u"Not Registered"
        index = appuifw.popup_menu(L_Unregistered)
        if index == 0:
            register_application()
        elif index == 1:
			about()
        elif index == 2:
            quit()
        else:
            pass
    elif is_registered == 1:
	appuifw.app.title = u"Registered"
        index = appuifw.popup_menu(L_Registered)
        if index == 0:
            about()
        elif index == 1:
            quit()
        else:
            pass
    else:
        pass
 
def about():
# About the application
    appuifw.note(u"Registration Example\nPython on Symbian", "info")
    start_application()
 
def promt_user():
# Prompt user for registration code
    global is_registered
    if is_registered == 0:
        appuifw.note(u"Application not registered!", "info")
 
def register_application():
# Ask and check for registration
    global is_registered
    if is_registered == 0:
        appuifw.note(u"Please enter the registration code", "info")
        regtry = appuifw.query(u"Enter Registration code", "text")
        if regtry == reg_code:
            is_registered = 1 # Successfully registered!
            appuifw.note(u"Thanks for registering!","info")
        else:
            appuifw.note(u"Invalid Registration Code!","error") # Registration failed!
    else:
        appuifw.note(u"Registered Application!","info")
 
    start_application()
 
 
 
appuifw.app.exit_key_handler = exit_key_handler
appuifw.app.screen='normal'
 
read_settings() # Check if registered or not
promt_user() # Prompt user if not registered
start_application() # Show application to user, accordingly
 
read_settings
prompt_user
start_application
phone_imei=sysinfo.imei()
reg_code = phone_imei[2]+phone_imei[0]+phone_imei[0]+phone_imei[8]
 
def read_settings():
# Read registration flag
    global is_registered   
    REG_FILE='C:\\system\\data\\registration\\confg.set'
    try:
        f=open(REG_FILE,'rt')
        try:
            content = f.read()
            config=eval(content)
            f.close()
            is_registered=config.get('is_registered','')
        except:
            appuifw.note(u"Cannot read settings file", "error")
    except:
        appuifw.note(u"Creating settings file", "info")
 
prompt_user
 
def promt_user():
# Prompt user for registration code
    global is_registered
    if is_registered == 0:
        appuifw.note(u"Application not registered!", "info")
 
start_application
is_registered
read_settings
 
def start_application():
# On start check if the application is registered or not and accordingly give menu pop-up  
options
    global is_registered
    if is_registered == 0:
	appuifw.app.title = u"Not Registered"
        index = appuifw.popup_menu(L_Unregistered)
        if index == 0:
            register_application()
        elif index == 1:
			about()
        elif index == 2:
            quit()
        else:
            pass
    elif is_registered == 1:
	appuifw.app.title = u"Registered"
        index = appuifw.popup_menu(L_Registered)
        if index == 0:
            about()
        elif index == 1:
            quit()
        else:
            pass
    else:
        pass
 
is_registered
 
def register_application():
# Ask and check for registration
    global is_registered
    if is_registered == 0:
        appuifw.note(u"Please enter the registration code", "info")
        regtry = appuifw.query(u"Enter Registration code", "text")
        if regtry == reg_code:
            is_registered = 1 # Successfully registered!
            appuifw.note(u"Thanks for registering!","info")
        else:
            appuifw.note(u"Invalid Registration Code!","error") # Registration failed!
    else:
        appuifw.note(u"Registered Application!","info")
 
    start_application()

Field	Description
Application title	Name used to described the application during installation and for the application caption (if a caption has not been specified). Default value: The script file name (without the `.py` extension) or folder name.
Version	Application major version, minor version, build number separated by a period or comma. You may find it convenient to specify the version number (anywhere) in your script using the SIS_VERSION keyword (e.g. SIS_VERSION = "1.0.0"). Default value: 1.0.0
UID	Every application has a unique UID. If you want to commercially distribute your application you will need to specify a UID in the protected range from symbiansigned.com. The UID can be specified anywhere in your script with the SYMBIAN_UID keyword (e.g. SYMBIAN_UID = UID). Default value: A UID in the development range based on a cryptographic hash of the script file name (suitable for development and using Open Signed Online).
Certificate, Private Key, Pass Phrase	Certificates are used to digitally sign the application. You will probably want to specify your own certificate (with associated key and pass phrase) in order to assert that you are the vendor. If you are going to Symbian Sign the application (which you will need to do to if you want to remove the installer warning message that your application is untrusted, or if you want additional capabilities) then you will need to sign the application using your company Publisher ID for submission. Default value: A default certificate is used to self-sign the SIS file; even if you are not going to distribute your application commercially you will
Additional Options	Other parameters, for example the icon and additional capabilities, can be specified. These are discussed below.
Profile	You can specify whether your application is a GUI or console application. Console applications print text to their own console (in the same way that scripts run in the PyS60 script shell print to its console). Default value: GUI application.
Heap Size	The minimum heap to reserve for your application, and the most that the heap can be allowed to grow to. Default value: The default settings should be suitable for most applications; however this can be changed if you have scripts or extensions that use significant memory.
Package As (Byte or Source code)	Whether or not your scripts are compiled to byte code (Python compiled scripts - PYC) before packaging. Byte code will run somewhat faster and additionally provide some anti-piracy protection for your script. Please remember that your SIS file must always contain a default.py file. You cannot package that as default.pyc. Default value: Scripts are converted to byte code.
1.4.x compatibility mode	If you're using the older Python runtime (1.4.5) specify this setting to ensure that the correct modules are bundled with your SIS file. Default value: Not 1.4.x compatibility mode.

Command	Description
icon	The icon used for your application in the phone UI, in SVG-Tiny format^[1]. Note that you must include the full path, and it can't have any spaces. Default value: The Python logo
textfile	A text file (or files) to be displayed during installation. There is a special format for specifying a set of language-specific text files (discussed in the multilingual section below).
vendor	Your company name. The use of vendor name in a mulitlingual application is discussed below. This is mandatory for signed applications. Default value: "Ensymble".
caps	Capabilities required by your application. The packager automatically gives your application those capabilities that can be granted by the user (see default value below). If you need other capabilities then you can specify this keyword followed by all needed capabilities, separated by "+" (e.g. caps +ReadUserData+WriteUserData) Default value: LocalServices, NetworkServices, ReadUserData, WriteUserData and UserEnvironment
extrasdir	If your application needs to make some files available in a public area of the phone filesystem - for example an icon editor application might install some demonstration icons, you can specify these in a location under drive root. Default value: Not used.
autostart	Application is registered to start on each device boot
runinstall	Application is automatically started after installation
drive	Drive where the package will be installed. There is usually no reason to change this. Default value: Applications can be installed to any drive

Capability Group	Capability Name	Description	Self-Signed	Open Signed Online	Open Signed Offline	Express Signed	Certified Signed
User Capabilities	LocalServices	Access to local services, such as bluetooth, USB, or infrared connections.	Yes (with user install-time confirmation)	Yes	Yes	Yes	Yes
	Location	Access to the phone's current location via the Location API.
	NetworkServices	Access to remote services (e.g. dialing a number, SMS, WLAN, GPRS). Services may incur a cost for the mobile device user.
	ReadUserData	Access to read confidential user data (e.g contact information)
	WriteUserData	Access to write confidential user data (e.g contact information)
	UserEnvironment	Access to services that provide data from users' physical surroundings (e.g. record audio, camera)
System Capabilities	PowerMgmt	Grants the right to kill any process in the system or to switch machine state (turn the phone off).	No	Yes	Yes	Yes	Yes
	ProtServ	Grants the right to a server to register with a protected name (starting with an “!”). Protected servers cannot be impersonated.
	ReadDeviceData	Read confidential network and phone data/settings (e.g. Cell IDs, mobile phone IMEI, and device settings like the list of installed applications.)
	WriteDeviceData	Write sensitive settings that control the behavior of the mobile device.
	SurroundingsDD	Access to logical device drivers that provide input information about the surroundings of the phone.
	SwEvent	Get Software Events (e.g. read keypresses, send messages to other applications etc.)
	TrustedUI	Grants the right to display dialogs in a secure UI environment
Restricted Capabilities	CommDD	Access to all communications equipment device drivers (e.g. WiFi, USB and serial device drivers etc).	No	No	Yes	No	Yes
	DiskAdmin	Access to file system administration operations that affect overall file-system integrity (e.g. mounting and unmounting a drive partition.)
	NetworkControl	The ability to modify or access network protocol controls (e.g. change the behaviour of all existing and future connections)
	MultimediaDD	Access to multimedia device drivers and priority access to multimedia APIs (e.g. sound, camera, video, etc.)
Device Manufacturer Capabilities	AllFiles	Grants visibility and write access to all files in the system	No	No	No	No	See Symbian Signed
	DRM	Grants access to alter DRM-protected content (not required for playback)
	TCB	Write access to executables and shared read-only resources. This is the most critical capability as it allows write access to executables, which contain the capabilities that define the security attributes of a process.

Self-Signed Free	SIS file installs on any phone (with "application untrusted" warnings). The user is asked whether or not they want to install the application based on the capabilities used. Grants access to the 5 "User Grantable" capabilities. Application is signed with a certificate created by the developer. User identity unknown (no basis for trust).
Open Signed Online Free	SIS file installs on a single phone (with "application untrusted" warnings). The phone user must sign the SIS prior to installation. Grants 13 capabilities. Application is signed on the Symbian Signed website Signer identity unknown (no basis for trust). Risk is low (application is locked to single phone, so reduced chance for malicious software to spread)
Open Signed Offline Not free	SIS file installs on (large) specified set of phones (with "application untrusted" warnings). Signer identity known (basis for trust) Risk is low (application locked to set of IMEIs) The certificate grants 17 capabilities. Developer Certificate used for signing is free, but in order to get this you must first purchase a publisher ID.
Express Signed Not free	SIS file installs any phone without warnings. The certificate grants 13 capabilities. Application is signed on the Symbian Signed website Signer identity known (basis for trust) Risk is low (application is regularly audited and certificate may be revoked if necessary) Developer must pay for publisher ID and signing
Certified Signed Not free	SIS file installs any phone without warnings. Application is signed on the Symbian Signed website Signer identity known (basis for trust) Risk is low (application is tested and certificate may be revoked if necessary) The certificate grants 17 capabilities (also basis for getting the Manufacturer capabilities, but these are not available for PyS60 applications) Developer must pay for publisher ID, testing and signing

Description	Function or Module	Required Capabilities
Global Key Capture	KeyCapture Module	SwEvent
Reading the GSM Location	Location Module(location.gsm_location())	Location, ReadDeviceData
Reading the internal GPS Location	Positioning Module	Location

Command	Description
lang	Comma separated list of two-character language codes. A few common codes are: English UK (EN), French (FR), German (GE), Spanish (SP), Italian (IT), Japanese (JA), Chinese PRC (ZH). The full list can be found in the Application Reference Example: to specify that the package support English, French and German you would add the following additional option: --lang=EN,FR,GE
caption	Caption, or a comma separated list of (long) captions in all the supported languages. Note that the order is the same specified in the `lang` command: --caption="English Caption","French Caption","German Caption"
shortcaption	Short caption, or a comma separated list of short captions in all the supported languages. Short captions are used in views where there isn't sufficient space to use the normal caption. Note the declaration order is the same as specified in the `lang` command: --shortcaption="EngCapt","FncCapt","GmCpt"
vendor	Vendor name or a comma separated list of all supported vendor names. Note the declaration order is the same as specified in the `lang` command: --vendor="BigCorp","French Big Corp","German Big Corp"

PyS60 Standalone Applications (Python on Symbian)

From Symbian Developer Community

Contents

Application Packager

Packager Options & Default Values

What Can't You do with the Application Packager?

Application configuration

SIS Configuration

Include other SIS files

Automation & Batching

How does the Application Packager Work?

Delivering the Python Runtime with your Application

Platform Security & Symbian Signed

What is Platform Security

Capabilities

Data Caging

What is Application Signing?

What Capabilities Should I Give My Applications

What Capabilities Should I give My Python Native Extensions?

Signing PyS60 Applications

Multilingual Applications

Application Packaging

Localising Python Scripts

Commercial applications

Registration code

Further Information

Open Issues

Contents

Stichbury said...

Croozeus said...

Stichbury said...

Croozeus said…

Croozeus said…

Hamishwillee said…

Views

Navigation

Toolbox

In other languages

OUR SITES

DEVELOPER PROGRAMS

Source

Website bugs

Documentation

Forums

CONTACT

Follow us