inst-bcb5.txt

zip算法的源码

ZipBuilder, for Borland C++ Builder version 1, 3, 4 , 5 and 6
Version 1.73
Original  by Chris Vleghert, [e-mail]
Latest adaptations by Roger Aelbrecht, [e-mail]

TZipBuilder is a translation of TZipMaster from Delphi to C++.
Its functional identical but it has been coded in C++ to make it easier 
for C++ users to understand and modify.

I am going to use the term "BCB" to mean "Borland C++ Builder".
----------------------------------------------------------------------

Before You Start
----------------
If you have an version of ZipMaster.pas installed in C++, you 
don't have to remove it, since this component has a different name.

You need to copy the redistributable modules to your desired
directory on your development computer.  

Copy \dll\*.DLL to your Windows System directory.
Copy \sfx\*.BIN to your Windows System directory.

Compiler Options
----------------

From version v1.70 there are compiler options that allow you to build
a smaller version of TZipBuilder. This means that certain options are
left out, making the final product smaller.

There are four options:

NO_SPAN : if this options is defined (or set) then the possibility of 
					spanning the archive over several disks (floppy disks) is no
					longer available.
					
NO_SFX  : if this options is defined (or set) then the possibility of 
          creating "self-extracting" archives is no longer build in 
          into the component, other components can still be used to 
          have the same result.
          
NO_STREAM : if this option is defined (or set) then the possibility of
         Zipping, unzipping data in streams is no longer provided.

INTERNAL_SFX : if this option is defined (or set) the old sfx code inside
				the component is included. Setting this option will un define 
				the option NO_SFX. This option is defined as default in ZipBuidler.h
        See also remark on internal sfx below
  				         
Any combination of these options is allowed.
There are two ways of defining the options:

- Define the options in the Project|Options tab Directories/conditionals
	and add the wanted options separated by a semicolon (;)
	
- Un-comment ( = remove the '//' at the start of the lines) the lines with 
  the #define statements at the beginning of ZipBuilder.h  immediately 
  after the #include statements                           

REMARK on INTERNAL SFX  
  
The use of the internal sfx code is not recommended. We strongly recommend the
use of an external package such as : 
- "TZipBuilderSFX" a plug-in for TZipBuilder that can be found at my web pages 
  http://web.wanadoo.be/driehoeksw				
- "ZipSFX" a Delphi package that works for both ZipMaster and ZipBuilder and
  can be found at http://www.mirkes.de/en/delphi/dzsfx.php

New Installation of TZipBuilder
-------------------------------
To get going quickly and correctly, please follow these instructions.  
Read them over once before starting.  If you don't understand a step, 
get help before you start the install!

1.  You HAVE TO install this package on a computer that has BCB.
    
2.  The files required to support the VCL are located in the
    VCL subdirectory.  You have two choices for how to proceed
    (option A is recommended):

      A) add the directory C:\...    \VCL to your VCL search path
         which can be set after step 3a.
         (C:\.. being the directory where you copied all files.)
                             or
      B) copy the files in \VCL to another directory
         already in your VCL search path

    If you want to use option A, the instructions for this are
    included below.  If you want option B, then please copy those
    files now.
  
3.  Install the VCL in C++ Builder:

    This procedure will install the VCL into the IDE.  After
    this, you will be able to see it on the "Components" tab.

    a) Open BCB and select File|Close All to make sure nothing is 
       disturbing the package installation process
       
    b) Choose Component|Install Component... from the menu

    c) Select the Tab 'Into New Package' and fill in:
       At 'Unit file name':    Browse and Select ZipBuilder.cpp from the
                               directory where you installed it.
       At 'Package file name': ZipPack ( In the directory Projects\Lib )
       At 'Description':   Free BCB Zip Package (or anything else you like)
       Select Ok

    d) You will be asked to confirm building the package;
      Answer NO on the confirm build question.
      
    e) Locate the dialog window with caption 'Package - ZipPack.bpl'
       On my system I have to minimise the editor window to see this window.
       Select 'Add'. In the Add Dialog select 'Add Unit' and 
       Browse and Select ZipLibs.cpp
       
    f) If you intend to build the component with the internal sfx then proceed 
       with the next file else skip to item g)
       Select 'Add'. In the Add Dialog select 'Add Unit' and 
       Browse and Select BuildIntSfx.cpp
       
    g) If you have chosen to set compiler conditionals in via the project
       options now you can do it else proceed with point h)
       Select 'Options' and choose the tab 'Directories/Conditionals'
       In the section Conditionals click the button marked with '...'
       In the lower small edit field of the new dialog type the condition
       you want, example INTERNAL_SFX, and click Add.
       Repeat typing and adding until all conditions are in the project
       then click OK and again OK
      
    h) Click the 'Compile' button, the compilation will start.
    
    i) Now Click the 'Install' button     
       Now you should get a message:
       Package ...\ZipPack.bpl has been installed.
       The following new components have been registered: TZipBuilder

    j) To finish choose from the main menu:
       File|Save all
       File|Close all

   Now the new component 'ZipBuilder' should be visible
   under the (new) Component tab of the IDE.


If you want to know more about installing packages:
  Look for 'Packages' in the CBuilder help system.
  i.e. Creating and Installing component packages.
                               
Installing New version when already a version exists
----------------------------------------------------
Copy all files in the ../VCL directory over the ones already on your
system.
  
   a) Open BCB and select File|Close All to make sure nothing is 
       disturbing the package installation process
       
   b) Choose Component|Install Component... from the menu  
    
   c) Select the Tab 'Into Existing Package' and fill in:
       At 'Unit file name':    Browse and Select ZipBuilder.cpp from the
                               directory where you installed it.
       At 'Package file name': Browse and select the package you installed
                               ZipBuilder before example ZipPack
       At 'Package description' you will find the description you gave when
                               the package was first installed
         
   d) Click OK normally you will get now the 'Package- ZipPack.bpl' dialog
      window
      Select 'Add'. In the Add Dialog select 'Add Unit' and 
      Browse and Select ZipLibs.cpp
       
   e) If you intend to build the component with the internal sfx then proceed 
       with the next file else skip to item f)
       Select 'Add'. In the Add Dialog select 'Add Unit' and 
       Browse and Select BuildIntSfx.cpp
       
   f) If you have chosen to set compiler conditionals in via the project
       options now you can do it else proceed with point h)
       Select 'Options' and choose the tab 'Directories/Conditionals'
       In the section Conditionals click the button marked with '...'
       In the lower small edit field of the new dialog type the condition
       you want, example INTERNAL_SFX, and click Add.
       Repeat typing and adding until all conditions are in the project
       then click OK and again OK
      
    g) Click the 'Compile' button, the compilation will start.
    
    h) Now Click the 'Install' button     
       Now you should get a message:
       Package ...\ZipPack.bpl has been installed.
       
       There is no registration message because ZipBuilder was already
       registered on your system
       
    i) To finish choose from the main menu:
       File|Save all
       File|Close all



                       C++ BUILDER HELP

See the 'ZipHelp.hlp' file in the Help subdirectory.


                       C++ BUILDER DEMO's
Installation
------------
1.  The CDemo directory has a number of sub directories one for BCB1,
    one for BCB3 specific files, etc. The files that are
    common to all environments are in the CDemoX directory.
    To install a demo you HAVE to COPY the files from the sub
    directory BCB5 to the CDemoX directory. Sometimes you will
    be asked to overwrite an existing file this is NOT an error
    and you should confirm the question.
    

2.  Important:
    a) You must set the include and library path in your project,
       not only for the demo's but also for new projects.
       This can be accomplished by choosing from the menu:
       Project|Options... and then the tab Directories/conditionals.

    b) The ZipBuilder component uses a language resource file for
       error and warning messages. This file must be linked into
       your project. (i.e. in your project source file.)
       This file must contain a statement like:
          USERC( "..\ZipMsgUS.rc" );
       Where ..\ is the path to this resource file.
       All language resources are grouped in the directory LangRes

                    DESCRIPTION OF DEMO PROJECTS

    Demo1 is a native C++ Builder port of the Delphi Zip Demo 1.
    This is a very complete File Manager type of program that lets
    you create archives, view archives, extract files, etc.  It can
    also turn .zip files into .exe files (and vice-versa).


                  Deployment of Your Programs

Any program you write using this package will require the two 
DLLs: ZIPDLL.DLL and UNZDLL.DLL to be present on each user's
hard disk.  You should have your install procedures put these
files into the WINDOWS SYSTEM directory (which is named differently
on some systems - especially WinNT systems).  If that isn't 
possible, then you should put them into the same directory as 
your .EXE program that uses them.

Also, the ZIPSFX.BIN module must be installed into the same
directory as the DLLs.  This module is only needed if your
application program needs to make .EXE archives.

IMPORTANT: Any .EXE archives you make with this package do
NOT need any supporting files on the end-user's computer!
This is very handy!

Of course, there are no distribution fees for the DLLs, or
any other part of the package.  This whole package is 
freeware, but does have some minor distribution restrictions
(mainly that you can't profit from the ZIP DLLs, and you need
to document where users can get source code).Please see 
README.TXT and LICENSE in the help for these restrictions.