From Symbian Developer Community

Contents 1 Intro 2 Legal Statement 3 Which PDT? Which RVCT Compiler? Which Perl? 3.1 PDT 3.2 Perl 3.3 RVCT 3.4 WINSCW 3.2.5 build 487 Patch 3.4.1 ConE 1.1.5 (Configuration Engine) Patch --- NOT REQUIRED IF USING PDT 1.5 or later 3.4.2 Raptor (SBSv2) Patch --- NOT REQUIRED IF USING PDT 1.5 or later 4 Headline Features 4.1 100% Open Source 4.2 Other Package Features Included 5 Testing and Analysis 5.1 Agile Browser Model 5.2 Smoke Testing 5.3 Emulator Manual Testing 5.4 Binary Compatibility Report 5.5 Open Defects 6 FCLs 6.1 stubs (sf/adaptation/stubs) 6.2 phone (sf/app/phone) 6.3 appsupport (sf/mw/appsupport) (New OSS FCL) 6.4 ipappprotocols (sf/mw/ipappprotocols) (New OSS FCL) 6.5 mds (sf/mw/mds) 6.6 remoteconn (sf/mw/remoteconn) (New OSS FCL) 6.7 uiresources (sf/mw/uiresources) 6.8 uitools (sf/mw/uitools) 6.9 usbservices (sf/mw/usbservices) 6.10 buildtools (sf/os/buildtools) (New OSS FCL) 6.11 deviceplatformrelease (sf/os/deviceplatformrelease) (New OSS FCL) 6.12 graphics (sf/os/graphics) (New OSS FCL) 6.13 kernelhwsrv (sf/os/kernelhwsrv) 6.14 lbs (sf/os/lbs) (New OSS FCL) 6.15 textandloc (sf/os/textandloc) (New OSS FCL) 6.16 beagleboard (sf/adaptation/beagleboard) 6.17 qemu (sf/adaptation/qemu) 6.18 platformtools (sf/mw/platformtools) (New OSS FCL) 7 Standard Stuff 7.1 Unpacking the PDK 7.1.1 Enough to run the WINSCW emulator 7.1.2 Enough to compile for the emulator 7.1.3 Everything, so you can compile TOOLS and ARMV5 as well 8 How to build 8.1 How to build the Platform using Hudson 8.2 How to build the platform using Helium 8.3 How to build the platform using Raptor 8.4 How to build a package using Raptor 8.5 How to build a package using Helium

Intro

Welcome to Live Release Notes - by putting these release notes into a Wiki page we hope to respond more quickly to your feedback and add the information that you really need. Please feel free to add more information to these release notes - we will be watching and may apply some editorial control if necessary.

The full logs from our Symbian^3 platform builds are now accessible here. PDK 3.0.g is published from build 295 and summarised here. Information on what we did to arrive at this release is recorded in an earlier version of this page.

Legal Statement

By downloading the Symbian Platform and its related documentation, you are agreeing to abide by the laws of the United Kingdom relating to the export and re-export of this controlled product. Namely, you agree that:

(a) this product is for your own use and will not be exported or re-exported, directly or indirectly to any other country and; (b) this product will not be used for purposes associated with chemical, biological or nuclear weapons or missiles capable of delivering such weapons, nor will they be resold if you know or suspect that they are intended or likely to be used for such a purpose.

The standard information about how to unpack the PDK is at the bottom of the page - see #Standard_Stuff

Which PDT? Which RVCT Compiler? Which Perl?

PDT

The platform may be built using PDT 1.5 plus the following patch:

• WINSCW 3.2.5. build 487

Note : This compiler upgrade is essential, PDK 3.0.g will not build with older compiler versions. Unfortunately it is not possible to build older PDK releases with this new compiler :(

It is possible to uses earlier versions of the PDT. The PDK candidate build was performed with PDT 1.1 plus following patches:

• Raptor 2.9.2 (+ Bug 1302 & Bug 1606 patches )
• ConE 1.1.5 (Configuration Engine)
• WINSCW 3.2.5 build 487

If you have an earlier PDT installed, you can patch it using separate zip files updates from the PDT 1.4 download page.

Perl

This PDK was prepared using Perl 5.6.1, however this version has since been withdrawn by ActiveState. For more information see Q&A. We have verified that it is possible to rebuild this PDK using Perl 5.10.1, see the #How_to_build section later in these release notes for specific instructions.

RVCT

This PDK was prepared using RVCT 2.2 (616)

WINSCW 3.2.5 build 487 Patch

Obtain the patch by following the link on the PDT download page.

Extract the file linked into the \x86Build directory under your Carbide installation, e.g. C:\Symbian\Tools\PDT_1.5\Carbide.c++\x86Build\

This compiler version cannot be used with earlier PDK releases. If you need to switch regularly, for example if supporting both S^2 and S^3, then install the new compiler to an alternative directory and use the env_switch.exe utility in ..\x86Build\env_switch to switch the environment variables. Note : The patch is not a complete compiler installation. If installing to an alternative directory copy the Symbian_Support directory from the PDT to your new compiler directory, e.g. C:\Symbian\Tools\PDT_1.5\Carbide.c++\x86Build\Symbian_Support

ConE 1.1.5 (Configuration Engine) Patch --- NOT REQUIRED IF USING PDT 1.5 or later

How to use ConE 1.1.5 patch with PDT 1.4 or earlier:

• To install ConE, unpack the contents of the ConE 1.1.5 patch ZIP file to <PDT_HOME>\ConE. Where PDT_HOME is the PDT installation folder on your machine (usually C:\Symbian\Tools\PDT_x.y)
• Add ConE to system path.

SET PATH=%PDT_HOME%\ConE;%PATH%

NOTE: This version of ConE is built to work with Pyton 2.5. This will not work with Python 2.6 or later versions.

Raptor (SBSv2) Patch --- NOT REQUIRED IF USING PDT 1.5 or later

The Raptor_2.9.2_p2 (1).zip file provided with PDT 1.4 is a complete replacement Raptor installation. There are 2 options for installation:

option 1 : Replace current Raptor installation

• Delete the current Raptor installation (e.g. for default install will be c:\Symbian\Tools\PDT_1.4\Raptor)
• Copy Raptor_2.9.2_p2 (1).zip into the <PDT_HOME> folder, e.g c:\Symbian\Tools\PDT_1.4 and extract. This should re-create the c:\Symbian\Tools\PDT_1.4\Raptor folder.

option 2 : Add as separate installation
This will allow you to switch between Raptor versions by changing environment variables.

• Copy Raptor_2.9.2_p2 (1).zip into any folder, e.g c:\apps and extract. This should re-create a raptor folder e.g. c:\apps\raptor.
• Update SBS_HOME and PATH environment variables to point to this new Raptor location e.g.

SET SBS_HOME=c:\apps\raptor
SET PATH=%SBS_HOME%\bin;%PATH%
 

Headline Features

100% Open Source

PDK 3.0.f was built with 43 packages still under the SFL license. All of the packages are now fully Open Source, so PDK 3.0.g is now built entirely from OSS repositories.

Other Package Features Included

Features included in this release are tagged Bugzilla with "Fixed_in_PDK_3.0.g".

ID	P	Status	Version	Product	Summary (4 tasks) ⇒
1391* Fixed_in_PDK_3.0.g, Key_Feature, Symbian^31391	P1	RESOLVED	unspecified	uiaccelerator	UI Acceleration migration to OpenWF
491* Fixed_in_PDK_3.0.g, Key_Feature, Symbian^3491	P3	RESOLVED	unspecified	organizer	CalDav for single calendar	[1]
495* Fixed_in_PDK_3.0.g, Key_Feature, Symbian^3495	P3	RESOLVED	unspecified	organizer	Multiple Calendar
496* Fixed_in_PDK_3.0.g, Key_Feature, Symbian^3496	P3	RESOLVED	unspecified	organizer	CalDAV for Multiple Calendars

Testing and Analysis

Agile Browser Model

The Agile Browser database for PDK 3.0.g is available here. See the AgileBrowser wiki page for instructions on how to use this file.

Smoke Testing

Automated smoke tests were run on PDK 3.0.g. Results are available here.
Pass rates for Symbian^3 are currently low (77.8%) due to a number of outstanding defects as listed below

bug 1301 - SWI certificate store missing in PDK 3.0 build
bug 1408 - Worldserver has been removed
bug 1559 - Missing IM header files in PDK_3.0.e
bug 1560 - Apparchitecture test code doesn't build against PDK_3.0.e
bug 1561 - Missing LBS header files and libraries in PDK_3.0.e
bug 1566 - Content Management tests are failing (E32User-CBase 47)
bug 1639 - Missing fbsmessage header file in Symbian^3
bug 1642 - Missing cimmessagepart header file in Symbian^3
bug 1645 - connect emulator to internet
bug 1662 - Calendar process not running after system startup
bug 1663 - Clock process not running after system startup
bug 1907 - Browser Control API tests cause WSERV crash

Emulator Manual Testing

There are a few quirks to be aware of when using the emulator from this release:

• ALF EGL Panic

On first time boot of the emulator you will see a panic ALF::ALF Panic EGL 1. This is non-fatal to the emulator. See Bug 1530 ALF::ALF Panic EGL 1 for more details.

• The emulator is configured for touchUI, but not working with mouse.

The UI is configured for touchUI, but clicking on the locations with your mouse doesn't work. You'll probably find that many parts of the UI when launched won't have a default selection, and you have to use the joypad. For instance, selecting your location has no default selection, and then moving into setting the time and date show a UI designed for touch rather than keypad, although the keypad is still functional.

• Homescreen doesn't pop up straight away

It doesn't go straight into homescreen after boot but simple displays the skin background. Don't worry, just hit the apps key to show all the apps, and hitting it again will take you to the homescreen. Navigating the homescreen is a bit more fun than usual, due to the touch UI (see above), but still functional.

Binary Compatibility Report

The list of public APIs which have their compatibility managed is published here: Symbian^2 Public API List. The management of compatibility breaks between Symbian^2 and Symbian^1 is here: Symbian^2 Compatibility Breaks

Compatibility reports comparing PDK 3.0.g with the Symbian^2 baseline are available online: there is one page reporting on compatibility of DLL import libraries and another which reports on compatibility of header files.

Open Defects

A snapshot of the open defects at the time PDK 3.0.g was prepared may be found here PDK_3.0.g_defects.

FCLs

This PDK was built using the FCL versions of the packages listed below: for each one we list the changes in the FCL which are not in the MCL.

The previous PDK also involved some FCLs, so we indicate which problems are now fixed in the MCL, and which FCLs are new to this build.

Cloning the source from Mercurial is made more awkward by using a mixture of MCLs and FCLs, but we provide a tool to help - see How to build the Platform for details.

Note that some of these FCLs are 'new' with respect to being an OSS rather than an SFL repository, as the PDK was built with all OSS repositories. The last listed change in each section is the changeset of the previous PDK, or in the case of new OSS repositories, the first submitted change.

stubs (sf/adaptation/stubs)

6ac4a04c9b06

Bug 1624 - systemswstubs\hwrmhapticsstubplugin\ missing from 201003 drop

phone (sf/app/phone)

801fe8ecf072	Merge
c84cf270c54f	Revision: 201003
74c6260f9112	Merge

appsupport (sf/mw/appsupport) (New OSS FCL)

a4d95d2c2540	Add Symbian Foundation splash screen
2e3d3ce01487	Revision: 201002

ipappprotocols (sf/mw/ipappprotocols) (New OSS FCL)

a8a9d504d1c2	Bug 1627 - sipproviderplugins\sipprovider\Test directory is missing, which breaks bld.inf
307788aac0a8	Revision: 201003

mds (sf/mw/mds)

e8c5a641faf0	merge Bug 1631 to latest drop
b73a2e62868f	Revision: 201003
23004ebfbb2d	Fix memory leak in harvesterserver (Bug 1631)

remoteconn (sf/mw/remoteconn) (New OSS FCL)

5a02d5ffccfe	transplant of Cenrep files from SFL for 'Bug 1848 - Remconn missing Cenrep files (crml, confml)'
3a9272b99e92	Adding back in missing def files: Bug 1841 - Remoteconn missing almost all def files.
c6656dc714fc	Bug 1828 - OSS backupengine missing all def files. -Transplanting from SFL repo
d0791faffa3f	Revision: 201003

uiresources (sf/mw/uiresources)

c9fe84c7602b	Merge
4ab28fdd25ad	Revision: 201003
f6fd4830a02c	Add LRU cache of rendered bitmaps, to improve redraw performance in the absence of graphics HW support for OpenVG

uitools (sf/mw/uitools)

68885df73637	Added creation of aknlayoutcompiler.exe as it isn't contributed. Note that this doesn't build at the moment. Raised Bug 1827 - AknLayoutCompiler needs arabica headers to build
d811f7979633	CdlCompiler.exe - exported binary not contributed anymore, so bulding from source.
de36cc5e7eac	Revision: 201001
159c4d6269be	Revision: 201001

usbservices (sf/mw/usbservices)

1d095efe60a1	Merge
7e15987c4500	Revision: 201003
7b8d21bf0d05	Workaround for Bug 1634 - Directory rndisui is missing in 201001 code drop

buildtools (sf/os/buildtools) (New OSS FCL)

da6ecb0ecd25	Repeat workaround for Bug 151 - export sbsv1 scripts etc from e32toolp.
97befe7e0e71	Include fixes for Bug 476 and 1371
3c318bb9d9cf	Fix for Bug 1371 - avoid generating OpenVG stub functions with invalid IMPORT_C decorations
fee529991771	Add missing make.exe and scpp.exe - required by extension makefiles
03fece2d3158	Fix Bug 476 by improving the check for the RVCT version of armasm
83f4b4db085c	Revision: 201005

deviceplatformrelease (sf/os/deviceplatformrelease) (New OSS FCL)

404b55120d53	Add ConE configuration files
b6ec929c591b	bldcodeline.hrh - Added ALF_USE_OPENWF_COMPOSITION for Bug 1391 - UI Acceleration migration to OpenWF
2de47816a1fb	Fix for engineering 'variant'. I was being a bit harsh on redefining 'LANGUAGE_IDS'.
f73116e08440	Changed engineering variant to just do UK English
a1489b9c8146	Making engineering 'variant' by copying western config.
e7fcfcd96f19	Transplanted FCL config changes from sfl repo @changeset 1708ba8e710e (tagged as PDK_3.0.f)
6d65d5acee06	Revision: 201003

graphics (sf/os/graphics) (New OSS FCL)

6c0e9409e175	patch for Bug 1863 - CEikCba::SetBoundingRect() calls deprecated RWindowBase::SetShape()
b89ec83ec7e1	Removing libvgi bridge as it collides with the KhronosRI and isn't usable. Exporting vgcontext.h and vgcont
250ac10a3d98	transplant of the KhronosRI work done on the SFL repo until changeset 22d01ad3515c - Includes 'Bug 1394 - KhronosRI - armv5 def files missing', 'Bug 1395 - KhronosRI - RVCT doesn't like 'OpenVGRI' qualified helper function names', and the ongoing work on 'Bug 31 - OpenVG implementation is a stub, so no icons or window decorations are displayed.'
8448d8896a16	Fix for Bug 1639 - Missing fbsmessage header file in Symbian^3
044bc69ecfee	Proposed workaround for Bug 1362 - libgles_cm.dll isn't contributed
406617043e2c	Fix for Bug 1666 - WServ NGA winscw max heap too small for running KhronosRI
31d73acc5459	Improved debugging for Bug 1530 - Panic during startup: ALF EGL 1
dd8110ac9267	Created NewGraphicsArchitecture branch for graphics work.
5d03bc08d59c	Revision: 201003

kernelhwsrv (sf/os/kernelhwsrv)

9954707c32dd

Merge the rom.flm and rom_sbs.pl changes

lbs (sf/os/lbs) (New OSS FCL)

d9c0c077fd9e	Bug 1628 - suplproxyprotocolmodule\group\bld.inf refers to missing bld.inf files
9cfd9a3ee49c	Revision: 201002

textandloc (sf/os/textandloc) (New OSS FCL)

1509585cd8bf	Bug 1860 - CHARCONV.CPP has a mismatched member TBool iFullyConstructed
deeea84a7639	Bug 1543 - Freetype.dll cannot be built. Added Freetype back in (same fix as in SFL repo)
1fb32624e06b	Revision: 201003

beagleboard (sf/adaptation/beagleboard)

ff677160c7d9

Added tag PDK_3.0.e for changeset 344fc5a7c938

qemu (sf/adaptation/qemu)

50cddb1eb3af

Bug 1513: "Too difficult to boot Syborg from PDK"

platformtools (sf/mw/platformtools) (New OSS FCL)

53df912d30f4	Added debugging info to mifconv.exe 'Bug 1414 - mifconv system() call to svgtbinencode seems to have a timing issue with Raptor 2.9.2+', which seems to alleviate the symptoms...
f453ebb75370	Revision: 201003

Standard Stuff

This section contains the information that you usually only need the first time you download a PDK.

Unpacking the PDK

The downloadkit utility is the easiest way to download and unpack a PDK, but these are the instructions for doing it by hand.

The PDK zip files often contain too many files for the ordinary zip utilities, so you will need to use 7-Zip. The extraction command is

7z x ''zipfilename''

which will extract the content into the current directory.

Enough to run the WINSCW emulator

To run the emulator, you only need

• 7z x binaries_epoc.zip
• 7z x binaries_epoc_additional.zip
• 7z x binaries_winscw.zip

This will give you an epoc32 tree in the current directory, and you should be able to type

\epoc32\release\winscw\udeb\epoc.exe

and have the emulator start up.

You can increase the functionality of the emulator by adding some of the R&D kit binaries

• 7z x bin_rndonly_monotype.zip
• 7z x bin_rndonly_aricent.zip

This adds 1) the iType rasteriser and the Monotype S60 fonts, for which the UI layout is currently designed, 2) the codecs which support playback of various audio formats, including MP3 files.

Enough to compile for the emulator

Add three more zip files on top of the runnable emulator (above)

• 7z x binaries_epoc_sdk.zip
• 7z x tools_epoc.zip
• 7z x build_BOM.zip

You will also need to install the PDT 1.5 or patch PDT 1.4 or earlier.

The build_BOM.zip file isn't strictly necessary, but it provides the files needed to remove the binaries associated with a package before you build a new version of it. It also provides the version information which enables you to get the source code directly from our Mercurial repositories. We recommend getting the source code from Mercurial, which makes future updates smaller, but we have also supplied the complete source snapshot as zip files.

• 7z x src_oss_app.zip
• 7z x src_oss_app_*.zip
• 7z x src_oss_mw.zip
• 7z x src_oss_mw_*.zip
• 7z x src_oss_os.zip
• 7z x src_oss_os_*.zip
• 7z x src_oss_adaptation.zip
• 7z x src_oss_adaptation_*.zip
• 7z x src_oss_tools.zip
• 7z x src_oss_tools_*.zip

This will give you snapshots of the code we used to build the PDK, and unpack into an sf tree in the current directory. The zip files that you download just contain yet more zip files, which is why the extra 7z commands are needed.

Everything, so you can compile TOOLS and ARMV5 as well

In addition to the emulator and tools, you will need the prebuilt ARMV5 binaries

• 7z x binaries_armv5.zip

This adds the epoc32/release/armv5 subtree. Just add the ARM Realview Compiler version 2.2 (Build 616) and away you go.

• 7z x binaries_epoc32_stlport.zip
• 7z x bin_redist_objective_systems.zip

This adds the stlport library needed to rebuild some of the tools, and the ASN1 libraries needed to compile some parts of LBS SUPL.

A description of how we build the Symbian^3 platform is on the Wiki - see [#How_to_build]. The logfiles and analysis results from our build are in build_logs.zip, if you want to compare your results with ours, and our summary is available online.

If you are interested in compiling ARMV5 binaries, you probably have access to a base port. If so, you might be interested in the remaining R&D kit binaries

• 7z x bin_rndonly_samsung.zip
• 7z x bin_rndonly_realnetworks.zip

How to build

The pages linked below describe all the steps required to fetch a PDK and re-build the complete platform or specific packages.

How to build the Platform using Hudson

Why not try building using Hudson - a simple web GUI based method that encapsulates the manual steps below. See Using Hudson for Building

How to build the platform using Helium

See How to perform a platform build of PDK 3.0.b using helium (steps have not changed since PDK 3.0.b so same instructions apply)

How to build the platform using Raptor

See How to perform a platform build of PDK 3.0.g using Raptor

How to build a package using Raptor

How to Build a Package

How to build a package using Helium

Setup Package Builds with FBF/Helium

Comments

Leo.z said…

William roberts said…

Sign in to comment…