Installing Different Series 60 Tools:

وصل برنامه هاي مختلف SDK

 

Substitute a drive to the location of your SDK installation:

جايگزين كردن يكي از دريو ها با محل SDK

 

To make it easier to work with your files and even be able to switch between different versions of SDK it’s best to create a BAT script which substitutes your drives to location of your SDK installation. For example something like below lines:

براي اينكه راحت تر بتوانيد با فايل ها كار كنيد و حتي بتوانيد راحت بين چند سيستم و ورژن سويچ كنيد بهتر است كه يك فايل BAT درست كنيد كه هميشه با روشن شدن كامپيوتر راه مي افتد و در آن BAT فايل دريوي را با محل اينستال شده SDK جايگزين ميكنيدִ به عنوان مثال جملاتي مانند زير را در اين فايل BAT ميگذاريد

 

@echo off

subst m: C:\Symbian\6.1\Series60

subst n: C:\Symbian\7.0s\Series60_v20

 

 

If you run this script each time you boot your computer it will substitute for example drive m: to location of your SDK version 1.2 which is installed under C:\Symbian\6.1\Series60 and n: to the SDK version 2.0 directory.

اگر اين سكريپت را هر وقت كامپيوترتان را روشن ميكنيد برانيد دريو m: را به محل اينستال كردن ورژن ١ִ٢ و دريو n: را به محل اينستال كردن ورژن ٢ִ٠ SDK وصل ميكندִ

 

Once you have done it you will see these drives in your file browser. Here below you see drive m:

وقتي اين كار را كرديد شما اين دريو هارا در ليست دريو هاي كامپيوترتان خواهيد ديدִ در عكس زير دريو m: را در اين ليست مي بينيد

 

 

For example you can create a directory called C:\Bin\MapDrive and put a BAT script called mapsymbiandrive.bat there.  Add this script to your startup (Start -> Programs -> Startup) so that it starts each time you start your computer.

به عنوان مثال ميتوانيد يك ديركتوري به نام C:\Bin\MapDrive درست كنيد و داخل آن يك فايل به نام  mapsymbiandrive.bat درست كنيد كه اين كار را براي شما انجام دهدִ اين فايل را به Startup خود اضافه كنيد Start -> Programs -> Startup كه هر وقت كامپيوتر را روشن ميكنيد راه بيفتدִ

 

 

Switching between different version of Series 60

سويچ كردن بين چند ورژن SDK

 

When you work with different projects and/or different SDKs you can switch between these versions and platforms easily by using a tool called EpocSwitch. Once this tool is installed you will see a small yellow icon like below:

وقتي با چند ورژن مختلف SDK يا چند پروژه مختلف كار ميكنيد ميتوانيد راحت بين چند ورژن سويچ كنيد با استفاده از برنامه اي به نام EpocSwitch وقتي اين برنامه را اينستال كنيد آيكون كوچكي در قسمت پايين دست راست كامپيوترتان به صورت زير خواهيد ديد:

 

 

To install EpocSwitch go to the directory \6.1\Series60\Series60Tools\epocswitch and read the ReadMe.txt file.

براي اينستال كردن اين برنامه به ديركتوري \6.1\Series60\Series60Tools\epocswitch  رفته و اطلاعات را در فايل ReadMe.txt بخوانيدִ

 

For example you can:

به عنوان مثال ميتوانيد كارهاي زير را انجام دهيد

 

*  Create a directory called C:\Bin\epocswitch and copy all files from \6.1\Series60\Series60Tools\epocswitch to C:\Bin\epocswitch.

*  يك ديركتوري به نام C:\Bin\epocswitch  درست كنيد و تمام فايلها را از \6.1\Series60\Series60Tools\epocswitch به اين ديركتوري يعني به C:\Bin\epocswitch كپي كنيد

 

 

*  Add epocswitch.exe to your startup (Start -> Programs -> Startup) so that it starts each time you start your computer.

*  فايل epocswitch.exe را به Startup خود Start -> Programs -> Startup اضافه كنيد كه هر وقت كامپيوترتان را روشن ميكنيد اين برنامه راه بيفتدִ

 

Open up your system enviroment settings (Control Panel -> System -> Environment) and remove any epoc related search paths from you path. Add %EPOCPATH% to your path; and accept your changes.

قسمت مشخصات سيستمتان Control Panel -> System -> Environment را باز كنيد (به عكس زير نگاه كنيد ) و هر گونه اطلاعاتي كه آنجا ميبينيد در مورد epoc path آنرا پاك كنيد و %EPOCPATH% را به path خود اضافه كنيدִ

 

 

 

*  If you click on the epoc icon above you will be able to choose the Setup to change the configuration:

*  اگر روي آيكون راه افتاده شده كليك كنيد ميتوانيد از يك ورژن به ديگري سويچ كنيد

 

 

For example here below is how you can setup your system where the first one is pointing to m: drive, which we earlier in mapdrive script pointed to C:\Symbian\6.1\Series60 so we start the SDK 1.2. The second one is reading from directory n:\ that we have substituted to C:\Symbian\7.0s\Series60_v20 and will help us to switch to SDK 2.0:

به عنوان مثال در زير ميبينيد كه چگونه ميتوانيد سيستمتان را تعريف كنيد كه اولين جملات SDK 1.2 را راه مي اندازد از طريق جايگزين كردن دريو m: به ديركتوري C:\Symbian\6.1\Series60 ִ جملات دوم نشان مي دهد كه چگونه دريو n: به دريو C:\Symbian\7.0s\Series60_v20 وصل ميشود كه SDK 2.0 را راه مي اندازدִ

 

// Sample EpocSwitch configuration file

[m: Series 60 1.2]

PROJECTPATH=m:\

EPOCROOT=\

EPOCPATH=m:\epoc32\gcc\bin;m:\epoc32\tools\

 

[n: Series 60 2.0]

PROJECTPATH=n:\

EPOCROOT=\

EPOCPATH=n:\epoc32\gcc\bin;n:\epoc32\tools\

 

Here you can download the settings.ini that I used in my system.

از اينجا ميتوانيد فايل settings.ini كه من در سيستم خود استفاده ميكنم

 

 

Now if you click on the epoc icon and choose Command Prompt:

حالا اگر روي آيكون كليك كنيد و Dos Prompt را انتخاب كنيد 

 

 

It will directly open the Command Prompt in directory n: which is pointing to right stuff and is ready to be used. There you can write epoc to start the emulator:

برنامه Dos Prompt مستقيما در n: باز ميشود, جايي كه همه مسائل و PATH درست است و آماده استفادهִ اگر بنويسيد epoc برنامه ورژن ٢ִ٠ راه مي افتد چون در n: اينكار را كرده ايدִ اگر در m: اينكار را بكنيد اموليتور ورژن ١ִ٢ باز خواهد شدִ

 

 

 

Note: If you open up your system enviroment settings (Control Panel -> System -> Environment) you will now notice that your EPOCPATH, EPOCPLAT and EPOCROOT changes each time you switch from one system to the other one:

توجه : اگر مشخصات سيستمتان را باز كنيد Control Panel -> System -> Environment خواهيد ديد كه هر دفعه سويچ ميكنيد مشخصات EPOCPATH, EPOCPLAT and EPOCROOT عوض خواهد شدִ

 

 

 

Installing mmpclick:

وصل كردن mmpclick

 

If you install mmpclick you will be able to right click on a mmp project file and build that project in stead of building in Dos Command Prompt.

اگر شما mmpclick را اينستال كنيد ميتوانيد براي ساختن پروژه تان يا براي كومپيل كردن فايلهايتان رايت كليك كنيد روي mmp و اين كار را انجام دهيدִ

 

Once mmpclick is installed you will see the mmp file in yellow color with an Epoc icon next to it like below:

وقتي شما mmpclick را اينستال كنيد فايل mmp كه پروژه سيمبيان را دارد به صورت رنگ زرد ديده خواهد شد با يك آيكن epoc در كنار آنִ

 

 

When right clicking on the mmp file you have different options like building the udeb or urel version:

وقتي روي mmp فايل با ماوس راست كليك كنيد Right Click امكانات مختلف را خواهيد ديدִ به عنوان مثال ساختن پروژه براي UDEB يا به صورت UREL كه اولي براي راندن كد خط به خط است و دومي براي زماني كه كد آماده رليز Release و فرستادن به بازار است ִ

 

 

Or creating the Visual C++ workspace:

يا ميتوانيد انتخاب كنيد كه پروژه ويژوال سي پلاس پلاس Visual C++ v را بسازيد

 

 

Note: mmpclick exist in SDK 1.2 but not in 2.0.

توجه كنيد كه mmpclick در SDK 1.2 وجود دارد ولي در SDK 2.0 وجود ندارد

 

Once you installed the SDK 1.2 go to directory  \6.1\Series60\Series60Tools\mmpclick and read the readme.txt file or do following:

وقتي كه SDK 1.2 را اينستال كرديد به ديركتوري \6.1\Series60\Series60Tools\mmpclick رفته و فايل readme.txt را بخوانيد كه اطلاعات زير را دارد:

 

1. Copy the file 'MMPClick.dll' and 'WSWITCH.DLL' to a directory on your local

   machine which is in the path. For example to C:\WINNT\system32

فايل MMPClick.dll و WSWITCH.DLL را به ديركتوري اي در كامپيوترتان كپي كنيد كه در path باشدִ به عنوان مثال به ديركتوري C:\WINNT\system32

 

2. Launch a command prompt and cd to the directory, which contains MMPClick.dll.

برنامه Dos Prompt را راه بياندازيد و به ديركتوري رفته كه اين DLL فايلها آنجا هستند (MMPClick.dll) و در آنجا دستور بعدي را اجرا كنيدִ

 

3. Type 'regsvr32 mmpclick.dll' at the command line. A message should appear

   confirming that the file was registered successfully.

اين دو DLL را ثبت كنيد به عنوان مثال با دستور regsvr32 mmpclick.dll كه جمله اي را خواهيد ديد كه ميگويد موفق شديد

 

4. Right click an mmp file in explorer to verify the build options appear. You might need to reboot your machine.

حالا اگر روي mmp فايل رايت كليك كنيد امكانات مختلف را خواهيد ديدִ اگر نديديد ممكن است احتياج به روشن خاموش كردن كامپيوترتان داشته باشيد

 

MB. This utility only need registering once as long as updated versions are placed

in the same directory.  To uninstall the utility type 'regsvr32 /u mmpclick.dll'.

توجه فرماييد كه شما فقط نياز داريد يكبار اين DLL ها را ثبت كنيد و تا زماني كه جاي اين فايل ها را عوض نكرده احتياج به ثبت دوباره نداريدִ اگر ميخواهيد ثبت را از بين ببريد ميتوانيد با دستور regsvr32 /u mmpclick.dll اين كار را بكنيد

 

 

Note: When working with this kind of right clicking go to for example m: in stead of C:\Symbian\6.1\Series60 to compile or to create the Visual C++ project if not you will get compile or build problem. It means once you have setup your system with substitution (like m: or n: etc) use them for working with your project and compiling and don’t use your c: drive to not get problem.

توجه : بعد از آنكه سيستمتان راه افتاد كه مثلا m: يا n: به ديركتوري SDK وصل شد ديگر فايلهايتان را از طريق C: كومپيل نكنيد و يا پروژه تان را براي Visual C++ c از طريق C: نسازيد بلكه هميشه به ديركتوري m: يا n: رفته و اينكار را انجام دهيدִ وگرنه ايراد در كومپيل خواهيد گرفت ִ

 

 

Series 60 Wizard installation:

راه انداختن Wizard براي Series 60

 

You can add the Series 60 Wizard feature to Visual Studio so that you can always easily create a new application framework without copy pasting form another project. Once you do it you will see when you start Visual C++ and try to create a new project:

شما ميتوانيد Series 60 Wizard را به برنامه Visual Studio خود اضافه كنيد كه هر وقت ميخواهيد برنامه اي از اول بسازيد براحتي از اين برنامه استفاده كنيد كه برايتان تمام فايل ها را بسازد بجاي اينكه فايل ها را از پروژه ديگري برداريد و اسم فايلها را تغيير دهيدִ

 

 

You will have the Series 60 Wizard option in the list:

بعد از وصل كردن شما امكان استفاده از Series 60 Wizard را خواهيد داشت

 

 

To add this feature to your Visual Studio follow steps described under:

بعد از آنكه SDK را اينستال كرديد اطلاعات در ديركتوري \6.1\Series60\Series60Tools\applicationwizard دنبال كنيد تا بدانيد چگونه اين برنامه را اينستال كنيد

 

\6.1\Series60\Series60Tools\applicationwizard    (Once you install the SDK you get this directory in C:\)

 

It means do following:

يعني عمليات زير را انجام دهيد

 

1. Copy AvkonAppWiz.awx and AvkonAppWiz.hlp files to Visual C++ template directory e.g

c:\Program Files\Microsoft Visual Studio\Common\MsDev98\Template

فايل هاي AvkonAppWiz.awx and AvkonAppWiz.hlp را به  Template ديركتوري Visual Studio يعني به ديركتوري c:\Program Files\Microsoft Visual Studio\Common\MsDev98\Template كپي كنيد

 

2. Start VC and Open File/New dialog. On "Projects" tab you should

find "Series 60 AppWizard" item.

برنامه Visual Studio را راه بياندازيد و قسمت File/New را انتخاب كنيدִ در قسمت Projects شما Series 60 AppWizard را خواهيد ديد  

 

3. When you create your project make sure you choose m: or n: and not C: and make sure you put it in the PATH for example under \Series60Ex. If not your Visual Studio might freeze or you might get compile errors.

وقتي كه پروژه خود را از طريق اين برنامه ميسازيد, دقت كنيد كه ديركتوري m: و n: كه قبلا ساختيد براي محل پروژه انتخاب كنيد نه ديركتوري c: و پروژه را جايي بگذاريد كه در PATH است به عنوان مثال زير ديركتوري اي كه ديگر مثال هاي سيمبيان است يعني زير ديركتوري \Series60Ex وگرنه هنگام ساختن پروژه ممكن است Visual Studio قفل كند يا هنگام كومپيل كردن فايل ها ايراد خواهيد داشتִ

 

Customizing Visual Studio

تنظيم كردن Visual Studio طبق دلخواه

 

  1. In Visual Studio if you want to see the content of different Symbian types like Descriptors, follow instructions from below link:

اگر ميخواهيد محتويات كلاس ها و تايپ هاي مختلف مخصوص سيمبيان را در Visual Studio ببينيد به مقالات زير رجوع كنيد

 

 

http://www.newlc.com/article.php3?id_article=274

 

 

  1. If you want to highlight Symbian codes like TInt and others, check following link where you can download and install the file usertype.dat:

اگر ميخواهيد كلاسهاي سيمبيان هنگام كد نوشتن با رنگ مخصوص مشخص باشند به مقاله زير توجه فرماييد و فايل  usertype.dat را برداريد و در سيستمتان اينستال كنيد

 

http://www.emccsoft.com/devzone/cvs.html

 

Note: You can also use the file from link 2 above for the issue described in point 1 above.

توجه فرماييد كه شما حتي ميتوانيد فايل معرفي شده در لينك ٢ بالارا  برداريد براي موضوع توضيح داده شده در لينك ١ بالا

 

 

 

 

 

 

 

ã 2004, Rosso Salmanzadeh