home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 613 / nSISUtil.sis / EN.nSISUtil.hlp (.txt) next >
Encoding:
EPOC Database  |  2000-08-02  |  16.9 KB  |  150 lines
  1. "DATA.APP)@
  2. AYou can learn more about our dynamic company, and expanding EPOC software portfolio, from Neuon's web site at http://www.neuon.com
  3. If you are a visionary C++, Java or OPL32 developer, motivated by doing something different, excited by challenges, relish the prospect of working with kindred spirits, and recognise the value of a dedicated support team, Neuon would like to hear from you.
  4. Neuon - where innovation and quality are principles, not an afterthought
  5. DnSISUtil enables .PKG/.SIS file creation and editing on an EPOC device. The main purpose for nSISUtil is to allow EPOC developers to create .SIS files on an EPOC platform without having to use a PC. This then enables developers to update applications on the net using only an EPOC device, for example.
  6. This help file assumes that the developer has an understanding of the principle concepts of using .PKG and .SIS files.  It is not the purpose of nSISUtil to be a tutorial for the creation of .PKG and .SIS files.  However, for ease of reference, extracts from the Symbian EPOC SDK on PKG syntax have been included in the file PKGSyntax (in EPOC help file format).  This is an option during installation and is installed to the \System\nSISUtil\ folder.
  7. If you intend creating a .SIS file which embeds another .SIS file, you should read the topic .SIS and the Shared Module Problem.
  8. After starting nSISUtil, use:
  9. PKG | New Ctrl+N to create a new .PKG file
  10. PKG | Open Ctrl+O to open an existing .PKG file.
  11. PKG | Recreate Ctrl+R to recreate a .PKG file from a .SIS file.
  12. SIS | Create Ctrl+C to create a .SIS file.
  13. SIS | Explore Ctrl+Q to explore a .SIS file and extract and/or read any included files.
  14. AA .PKG file must first exist before a .SIS file can be created. nSISUtil provides the option to create a new .PKG file, or edit an existing one.
  15. To Create a new .PKG file, use the menu item PKG | Open (Ctrl+N).
  16. To open an existing .PKG file, use the menu item PKG | Open (Ctrl+O)
  17. For assistance with the syntax used in .PKG files, read the optional help file PKGSyntax in the \System\nSISUtil\ folder
  18. BnSISUtil offers the option to recreate a .PKG file from the information contained in a SIS.file.  The .SIS file may either be a complete .SIS which has yet to be installed, or the .SIS stub file which remains in a \System\Install\ folder after installation. 
  19. To recreate a .PKG file, use the menu item PKG | Recreate (Ctrl+R)
  20. In the folder navigator, select the .SIS file from which you want to reconstruct the .PKG data. 
  21. Tip:    In the navigator, you can change drives using the Tab key
  22. The reconstructed .PKG file will be displayed.
  23. Important:    Before saving the data to a new .PKG file, you should check the reconstructed data as multi-language filenames cannot be reconstructed completely
  24. Use Save to PKG (Ctrl+S) to save the reconstructed data to a .PKG file.
  25. ]ATo create a .SIS file:
  26. A .PKG file must first have been created (see the topic Open/Create .PKG).
  27. Use the menu item SIS |Create Ctrl+C and select a .PKG file in the folder navigator.
  28. Tip:    In the navigator, you can change drives using the Tab key
  29. Enter a filename for .SIS file.
  30. A message will appear if the .SIS file has been successfully created.
  31. AThis software has been extensively tested and no problems have been found.
  32. However, neither the Author nor Neuon warrant that this software is error free. In no event shall the author or Neuon be liable for any consequential, special, incidental or indirect damages of any kind arising out of the delivery, performance or use of the software, even if the Author or Neuon have been advised of the possibility of such damages. 
  33. Use of this software is entirely at the Users risk.
  34. Table1
  35. title
  36. synonym
  37. Table1
  38. ColA1
  39. ColB1
  40. ColA2
  41. ColB2
  42. ColA3
  43. ColB3
  44. ColA4
  45. ColB4
  46. Index1
  47. ColA4
  48. LIf you are creating a .SIS which embeds another .SIS file (e.g. your .PKG file contains an entry like @
  49. Another.sis
  50. ,(0x00000000), you should be aware of the following.  In this explanation, module.sis applies to any embedded .SIS inside a parent .SIS.
  51. 1.    The embedded method of .SIS incorporation has limitations, which are of note for shared modules (typically a shared.opx) which are packaged in their own separate shared module.SIS file.
  52. 2.    After an installation, a residual .SIS stub is created in \system\install\ for the dependant parent .SIS and for each of its embedded shared module.SIS. These stubs contain important information for use by EPOC Install and the Control panel option 'Add/Remove'.
  53. 3.    To ensure that
  54. 1)    any shared module is only removed when no other dependant application requires it, and...
  55. 2)    the user is warned that removing the  shared module directly may break other applications,
  56. requires every .SIS stub for a dependant parent .SIS to be in C:\system\install\.
  57. It does not matter on which drive the .SIS stub for any embedded shared module.SIS is located, nor does it matter on which drive the dependant applications or shared module(s) are located. The key requirement is that the .SIS stub for the dependant parent is in C:\system\install\.
  58. 4.    Unfortunately, this cannot be guaranteed for two reasons:
  59. 1)    Unlike installations on the machine itself, which always use C:\system\install\, the PC based EPOC Install program places .SIS stubs in the \system\install\ folder dependent on the options originally used in the parent.sis .PKG file. If all files can be installed on an optional drive selected by the user, this same drive is used for the .SIS stubs. If this is D, then the .SIS stubs are placed in D:\system\install\. The same is true if the .PKG file mandates that all files must be on drive D.
  60. 2)    Users may move .SIS stubs from C:\system\install\ to D:\system\install\, partly prompted by what EPOC Install may have done.
  61. When the last dependant parent.SIS stub in C:\system\install\ is removed, or there are no dependant parent .SIS stub in C:\system\install\, removing a parent app.SIS will mean that shared modules will be deleted, or no warning given, even if a dependant app remains on the machine.
  62. So, what does this mean?
  63. When your app depends on a shared module, in order to ensure that the removal of your application does not break someone else's which also uses the same shared module, this three point plan is recommended:
  64. 1.    You exploit the EPOC Install behaviour which forces the parent .SIS stub to be placed in C:\system\install\, even if the drive location for all other files was drive D, by choice or by design. This is done by including one option in the parent .PKG file which has a hard-coded drive of C. Some possibilities are:
  65. a.  To include a real file which is installed on drive C
  66. "some real file"-"C:\some folder\some real file",FF
  67. b.  To specify a deletion requirement, when the app is removed, for a real or bogus file on drive C
  68. ""-"C:\system\apps\myapp\myapp.ini",FN
  69. ""-"C:\bogus stub fix",FN
  70. 2.    You embed the shared module.SIS in the parent .SIS file
  71. shared.sis
  72. ,(0x00000000)
  73. 3.    Users are advised not to move any parent .SIS stub.
  74. pBThe menu item Tools | Preferences provides options to customise nSISUtil
  75. s operation.  These options are provided for advanced users only.
  76. Optimise removes the source file path. This will make the .SIS file a bit smaller.
  77. Skip syntax check prevents nSISUtil  performing a syntax check while analysing a .PKG file.
  78. Reverse files makes nSISUtil process the files which were defined in the .PKG in the reverse order.
  79. Max files sets the maximum number of files which can be defined in a .PKG (the default = 128). Changing this number will affect the memory used by nSISUtil. More memory is used the greater the maximum limit.
  80. Arial
  81. Arial
  82. Arial
  83. Arial
  84. Arial
  85. Arial
  86. Arial
  87. Arial
  88. Arial
  89. Arial
  90. Arial
  91. Arial
  92. Arial
  93. Swiss
  94. Arial
  95. Arial
  96. Arial
  97. Arial
  98. Arial
  99. Arial
  100. Arial
  101. AThe Author would like to express his thanks to the following people, without whom nSISUtil would never have been the application it is today:
  102. Beta testing:
  103. Ralph Sprenger
  104. Henry Hirst
  105. Ben Vaisvil
  106. Phil Spencer
  107. Support:
  108. Special thanks to Henry Hirst, Alex Wilbur & Richard Betts for the five OPX's used, the first four of which are publicly available from the Neuon web site www.neuon.com
  109. nListbox.OPX
  110. nDirNav.OPX
  111. nMPD.OPX
  112. nDiskTools.OPX
  113. Neuon.OPX
  114. About NeuonR
  115.     NSISUtil!
  116. Welcome to nSISUtilR
  117.     NSISUtil!
  118. PreferencesR
  119.     NSISUtil!
  120. Open/Create .PKGR
  121.     NSISUtil!
  122. Recreate .PKGR
  123.     NSISUtil!
  124. Create .SISR
  125.     NSISUtil!
  126. Explore .SISR
  127. To explore a .SIS file, use the menu item SIS | Explore (Ctrl+Q).  After selecting the required .SIS file in the folder navigator, the contents of the .SIS file will be displayed.
  128. Tip:    In the navigator, you can change drives using the Tab key
  129.     NSISUtil!
  130. Licence and DistributionR
  131. {nSISUtil is copyright (c) Jens Kaminski and Neuon 1998-2000.  nSISUtil is provided as freeware, subject to the Disclaimer.
  132.     NSISUtil!
  133. DisclaimerR
  134.     NSISUtil!
  135. Contacting the AuthorR
  136. If you wish to contact the author, Jens Kaminski, for more information concerning nSISUtil, to report any bugs, or just for a chat:
  137. Email - jens@neuon.com
  138. ICQ - 4681731
  139.     NSISUtil!
  140. CreditsR
  141.     NSISUtil!
  142. ".SIS and the shared module problemR
  143.     NSISUtil!
  144. Installer preferences5
  145. This option can be accessed in Tools | Installer preferences on the menu.
  146. This allows you to change the settings of the Installer, such as:
  147. Delete .SIS installation file?
  148. Prefered language
  149.     NSISUtil!
  150.