Nokia Python for S60 1.4.5 Library Reference

需积分: 3 171 浏览量更新于2024-08-02 收藏 641KB PDF 举报

"Python for S60 v1.45 Library Reference" 本文档是关于Symbian S60平台上Python环境的开发参考资料，主要面向的是Python for S60版本1.4.5。这个版本由诺基亚公司创建，并且遵循Apache License Version 2.0的授权协议。原始软件（包括诺基亚公司的修改）基于Python 2.2.2的相应许可证。此文档旨在简化在Symbian操作系统上的应用开发，并提供对Symbian C++ API的脚本解决方案。 **1. 引言** - **范围**: 这个文档覆盖了Python for S60平台的基本概念、API概览以及针对S60平台的编程问题。 - **受众**: 主要面向开发者，尤其是那些希望在S60设备上使用Python进行应用程序开发的技术人员。 - **命名约定**: 文档中可能包含特定的命名规则和约定，以保持代码的一致性和可读性。 **2. API概述** - **Python标准库**: 提供了Python 2.2.2的标准库，包含各种通用模块，如数据结构、操作系统接口、网络通信等。 - **Python for S60扩展**: 为S60平台定制的Python扩展，这些扩展提供了与Symbian系统更紧密集成的功能，如访问设备硬件、多媒体服务、设备API等。 - **第三方扩展**: 可能包括由社区或其他开发者创建的扩展，这些扩展增强了Python for S60的功能，如额外的库或工具。 **3. S60平台Python编程的选定问题** - **并发方面**: S60平台上的Python程序需要考虑多线程和并发执行的问题，这可能涉及到线程同步、事件循环等技术。 - **运行Python for S60脚本**: 解释如何在S60设备上执行Python脚本，可能涉及启动环境、脚本部署和调试方法。 - **独立运行和集成应用**: 介绍如何将Python脚本打包成独立的应用程序，以及如何与其他S60 C++应用集成。本文档详细阐述了Python for S60的API参考、编程指南和实际开发中的注意事项，对于想要在Symbian S60设备上利用Python进行移动应用开发的开发者来说，是一份重要的参考资料。开发者可以借此了解如何利用Python的灵活性和强大的功能来创建与S60平台深度集成的应用程序。

A tuple containing the ﬁve components of the Python for S60 version number: major, minor, micro,

release tag, and serial. All values except release level are integers; the release tag is a string. A value

other than ’final’ for the release tag signiﬁes a development release. The pys60 version info

value corresponding to the Python for S60 version 1.2 is (1, 2, 0, ’final’, 0).

s60 version info

The SDK version with which this Python was compiled (tuple). The following values are possible:

•(1, 2) for S60 1st Edition

•(2, 0) for S60 2nd Edition

•(2, 6) S60 2nd Edition Feature Pack 2

•(2, 8) S60 2nd Edition Feature Pack 3

•(3, 0) S60 3rd Edition

Examples:

>>> import e32

>>> e32.pys60_version

’1.2.0 final’

>>> e32.pys60_version_info

(1, 2, 0, ’final’, 0)

>>> e32.s60_version_info

(2, 0)

>>>

is ui thread()

Returns True if the code that calls this function runs in the context of the UI thread; otherwise

returns False.

start exe(ﬁlename, command [,wait ])

Launches the native Symbian OS executable ﬁlename (Unicode) and passes it the command string.

When wait is set, the function synchronously waits for the exit of the executable and returns a

value that describes the exit type. Possible values are 0 for normal exit and 2 for abnormal exit.

start server(ﬁlename)

Starts the Python script in ﬁle ﬁlename (Unicode) as a server in its own process. Note that appuifw

module is not available to a server script.

reset inactivity()

Resets the timers since the user was last active. As a consequence, the device backlight is normally

turned on when this function is invoked.

inactivity()

Returns the time in seconds since the user of the device was last active.

4.1.2 Ao lock Type

class Ao lock()

Creates an Ao lock instance. A Symbian active object based synchronization service. This can

be used in the main thread without blocking the handling of UI events. The application should

not exit while a thread is waiting in Ao lock. If Ao lock.wait is called while another wait call

is already in progress, an AssertionError is raised.

Instances of Ao lock type have the following methods:

wait()

If the lock has already been signaled, returns immediately. Otherwise blocks in wait for the lock

to be signaled. Only one waiter is allowed, so you should avoid recursive calls to this service. wait

can only be called in the thread that created the lock object. During the wait, other Symbian-

active objects are being served, so the UI will not freeze. This may result in the UI callback code

10 Chapter 4. Operating System Services and Information

being run in the context of the thread that is waiting in Ao lock. This must be considered when

designing the application logic.

signal()

Signals the lock. The waiter is released.

4.1.3 Ao timer Type

The rationale for the Ao timer type is that you cannot cancel a pending e32.ao sleep. This is

problematic if e.g. the user exits an application which is sleeping. In this case a panic would occur

since the sleep is not cancelled - this is the reason you should avoid using e32.ao sleep and instead

use the Ao timer with appropriate cancel calls if there is for example a possibility for the user to exit

the application during a sleep.

class Ao timer()

Creates an Ao timer instance. A Symbian active object based sleeping service. This can be used

in the main thread without blocking the handling of UI events. The application should not exit

while a thread has a pending after call in Ao timer. Only one after invocation can be pending

at time for each instance of this type.

Instances of Ao timer type have the following methods:

after(interval [,callback ])

Sleeps for the given interval without blocking the active scheduler. When the optional callback is

given, the call to after returns immediately and the callback gets called after interval.

cancel()

Cancels a pending after call.

4.2 sysinfo — Access to system information

The sysinfo module oﬀers an API for checking the system information of a S60 mobile device.

Note: The method ring type is not available for S60 1st Edition.

The sysinfo module has the following functions:

active profile()

Returns the current active proﬁle as a string, which can be one of the following: ’general’,

’silent’, ’meeting’, ’outdoor’, ’pager’, ’offline’, , ’drive’, or ’user <profile

value>’.

battery()

Returns the current battery level. On devices based on S60 2nd Edition Feature Pack 1 (S60 2.1)

or earlier the value ranges from 0 (empty) to 7 (full). On newer devices the value ranges from 0

(empty) to 100 (full). On the emulator the value is always 0.

Note: The returned value may be incorrect while the device is being charged.

display twips()

Returns the width and height of the display in twips. For a deﬁnition of a twip, see Chapter 10,

Terms and Abbreviations.

display pixels()

Returns the width and height of the display in pixels.

free drivespace()

Returns the amount of free space left on the drives in bytes, for example {u’C:’ 100}. The keys

in the dictionary are the drive letters followed by a colon (:).

imei()

Returns the IMEI code of the device as a Unicode string or, if running on the emulator, the

hardcoded string u’000000000000000’.

4.2. sysinfo — Access to system information 11

剩余109页未读，继续阅读

ragnarok

粉丝: 0
资源: 4

Nokia Python for S60 1.4.5 Library Reference

Python S60 平台 v1.45 C盘版

Python_v1.45 for s60v3整合插件汉化修正版

Python1.45

python image library

pythonforandroid_r4.apk

Python For Data Analysis (2013)高清完整PDF版

Python Essential Reference 4th 原版PDF by Beazley

Python库 | honeybee_energy-1.45.1-py2.py3-none-any.whl

python

Spark for Python Developers 无水印pdf 0分

最新资源