1 This readme describes the way to run glib test cases.

     2 

     3 When running the glib test cases please take care of the following:

     4 

     5 1. The hardware image must have the language variants dlls if the ATSINPUT is created using genatsmodules_locale_specific.bat.

     6 Language variant DLLs will not be flashed on to the device if we are using Engineering  English image. So we have to create our own customised image for testing the glib module.

     7 

     8 Steps to be followed to test glib module.

     9 a. Create a locale.iby file with following entries in the file.

    10 /*

    11 * ==============================================================================

    12 *  Name        : locale.iby

    13 *  Part of     : locale

    14 *  Description : IBY file for locale

    15 *  Version     : 

    16 *

    17 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.

    18 *

    19 * This library is free software; you can redistribute it and/or

    20 * modify it under the terms of the GNU Lesser General Public

    21 * License as published by the Free Software Foundation; either

    22 * version 2 of the License, or (at your option) any later version.

    23 *

    24 * This library is distributed in the hope that it will be useful,

    25 * but WITHOUT ANY WARRANTY; without even the implied warranty of

    26 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

    27 * Lesser General Public License for more details.

    28 *

    29 * You should have received a copy of the GNU Lesser General Public

    30 * License along with this library; if not, write to the

    31 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,

    32 * Boston, MA 02111-1307, USA.

    33 * ==============================================================================

    34 */

    35 

    36 

    37 

    38 #ifndef LOCALE_IBY

    39 #define LOCALE_IBY

    40 

    41 file=\epoc32\release\armv5\urel\elocl.01            SHARED_LIB_DIR\elocl.01

    42 file=\epoc32\release\armv5\urel\elocl.37            SHARED_LIB_DIR\elocl.37

    43 file=\epoc32\release\armv5\urel\elocl.42            SHARED_LIB_DIR\elocl.42

    44 file=\epoc32\release\armv5\urel\elocl.25            SHARED_LIB_DIR\elocl.25

    45 file=\epoc32\release\armv5\urel\elocl.07            SHARED_LIB_DIR\elocl.07

    46 file=\epoc32\release\armv5\urel\elocl.03            SHARED_LIB_DIR\elocl.03

    47 file=\epoc32\release\armv5\urel\elocl.54            SHARED_LIB_DIR\elocl.54

    48 file=\epoc32\release\armv5\urel\elocl.10            SHARED_LIB_DIR\elocl.10

    49 file=\epoc32\release\armv5\urel\elocl.04            SHARED_LIB_DIR\elocl.04

    50 file=\epoc32\release\armv5\urel\elocl.49            SHARED_LIB_DIR\elocl.49

    51 file=\epoc32\release\armv5\urel\elocl.09            SHARED_LIB_DIR\elocl.09

    52 file=\epoc32\release\armv5\urel\elocl.51            SHARED_LIB_DIR\elocl.51

    53 file=\epoc32\release\armv5\urel\elocl.02            SHARED_LIB_DIR\elocl.02

    54 file=\epoc32\release\armv5\urel\elocl.57            SHARED_LIB_DIR\elocl.57

    55 file=\epoc32\release\armv5\urel\elocl.45            SHARED_LIB_DIR\elocl.45

    56 file=\epoc32\release\armv5\urel\elocl.17            SHARED_LIB_DIR\elocl.17

    57 file=\epoc32\release\armv5\urel\elocl.59            SHARED_LIB_DIR\elocl.59

    58 file=\epoc32\release\armv5\urel\elocl.15            SHARED_LIB_DIR\elocl.15

    59 file=\epoc32\release\armv5\urel\elocl.05            SHARED_LIB_DIR\elocl.05

    60 file=\epoc32\release\armv5\urel\elocl.32            SHARED_LIB_DIR\elocl.32

    61 file=\epoc32\release\armv5\urel\elocl.68            SHARED_LIB_DIR\elocl.68

    62 file=\epoc32\release\armv5\urel\elocl.67            SHARED_LIB_DIR\elocl.67

    63 file=\epoc32\release\armv5\urel\elocl.70            SHARED_LIB_DIR\elocl.70

    64 file=\epoc32\release\armv5\urel\elocl.18            SHARED_LIB_DIR\elocl.18

    65 file=\epoc32\release\armv5\urel\elocl.08            SHARED_LIB_DIR\elocl.08

    66 file=\epoc32\release\armv5\urel\elocl.27            SHARED_LIB_DIR\elocl.27

    67 file=\epoc32\release\armv5\urel\elocl.76            SHARED_LIB_DIR\elocl.76

    68 file=\epoc32\release\armv5\urel\elocl.13            SHARED_LIB_DIR\elocl.13

    69 file=\epoc32\release\armv5\urel\elocl.78            SHARED_LIB_DIR\elocl.78

    70 file=\epoc32\release\armv5\urel\elocl.16            SHARED_LIB_DIR\elocl.16

    71 file=\epoc32\release\armv5\urel\elocl.26            SHARED_LIB_DIR\elocl.26

    72 file=\epoc32\release\armv5\urel\elocl.28            SHARED_LIB_DIR\elocl.28

    73 file=\epoc32\release\armv5\urel\elocl.79            SHARED_LIB_DIR\elocl.79

    74 file=\epoc32\release\armv5\urel\elocl.06            SHARED_LIB_DIR\elocl.06

    75 file=\epoc32\release\armv5\urel\elocl.33            SHARED_LIB_DIR\elocl.33

    76 file=\epoc32\release\armv5\urel\elocl.39            SHARED_LIB_DIR\elocl.39

    77 file=\epoc32\release\armv5\urel\elocl.14            SHARED_LIB_DIR\elocl.14

    78 file=\epoc32\release\armv5\urel\elocl.93            SHARED_LIB_DIR\elocl.93

    79 file=\epoc32\release\armv5\urel\elocl.96            SHARED_LIB_DIR\elocl.96

    80 file=\epoc32\release\armv5\urel\elocl.31            SHARED_LIB_DIR\elocl.31

    81 file=\epoc32\release\armv5\urel\elocl.30            SHARED_LIB_DIR\elocl.30

    82 

    83 file=\epoc32\release\armv5\urel\SHIFTJIS.DLL            SHARED_LIB_DIR\SHIFTJIS.DLL

    84 file=\epoc32\release\armv5\urel\EUCJP_PACKED.DLL      SHARED_LIB_DIR\EUCJP_PACKED.DLL

    85 

    86 #endif

    87 

    88 

    89 b.Place the locale.iby file in \EPOC32\rom\Include directory

    90 c.Open S60.iby file from  \EPOC32\rom\Include directory and make an entry in the file as given below

    91    #include <locale.iby>                      

    92 d. Give the following command to build the scarfe image

    93     isis_build.bat -rom -type=scarfe

    94  

    95 2. Ensure that locales.txt is present at \epoc32\winscw\c\resource on emulator and at c:\resource on Hardware. If not present, copy the same to the specified location.

    96 

    97 3. The following are manual test cases:

    98         a. tmanual - Prints instructions on screen. Please follow them. If nothing is printed it is considered as failed.

    99 

   100         b. log_manual1 - When the test case is executed, the getchar() API should not be executed. If it is executed the test case is considered as failed.

   101 

   102         c. log_test - prints the following message "test domain-message: test message printed successfully". If it does not print it, the test case is considered as failed.

   103 

   104         d. mem_profile_test - This will print memory profile on the screen. If it does not print the memory profile the test case is considered as failed.

   105         

   106         e. error_check_mutexes - This will terminate at some point inside error_check_mutexes function,if, in any case it creates result file then consider is as failed.

   107 

   108 4. To generate the ATS test drops for non locale specific APIs use the batch file "genatsmodules.bat" placed in glib\internal. This will generate the "ATSINPUT" folder. 

   109    For locale specfic APIs use genatsmodules_locale_specific.bat placed in glib\internal.

   110 

   111 5. At the end of the all the test cases a log file c:\logtests.txt will be generated which will describe the reason for failures if any.