install next suit

BERG NEXT SUITE INSTALLATION (1.0.3)

1 Copyright © BergSoft 2008. All Rights Reserved.

Next Suite A1 INSTALLATION



Welcome

Welcome to Berg NextSuite Installation manual.

This document will help you to install NextSuite components on your system.

If you are already familiar with installing components, this document may help you to quickly install

NextSuite updates when they are available.

If you are inexperienced with installing components in Delphi & C++ Builder, or you experience

installation problems this document will help you to successfully install NextSuite.

If you have any more questions, please contact us on [email protected].

NextSuite Version

As every major component in Next Suite own version, NextSuite also own some kind of “global” Version

number. This number is in following format and it may be found in archive file name in following format:

majorversion.month.year.release

Example: 4.4.08.2

Helpful links

1. BergSoft Support Board (Web Forum): www.bergsoft.net/forum

2. Members Section & New Versions of Components: bms.bergsoft.net

3. Articles & Tutorials: dn.bergsoft.net

mailto:[email protected]

http://www.bergsoft.net/forum

http://bms.bergsoft.net/

http://dn.bergsoft.net/



Installation steps

Follow these 3 steps in order to successfully install Berg Next Suite components in your Delphi/Borland

C++ Builder.

IMPORTANT NOTE: If you have previous version of Next Suite installed, please uninstall previous version first (!).

1. Download and extract components on local hard drive

2. Install packages in IDE

3. Uninstalling components

If you have problems with installing components please read “Common problems during installation”

section of this document.



1. Download and extract Components on local hard drive

Please download components from members section of site (http://bms.bergsoft.net/).

Components installer (setup) or zip archive distribution, which to use?

Berg Next Suite components are distributed in 2 formats:

1. Components Installer (exe)

2. Zip archive (zip)

Component installer is better choice for novice users, and for users who don’t update components too

often. When installing new version, uninstaller will uninstall old version (delete all files), and then setup

for new version need to be started.

Zip archive is better choice for updating components after small changes (bug fixed, requested feature

added). All is need to delete old “Sources” sub-folder and extract new files into it. Sometime only few

files need to be replaced. If changes are minor and run-time only, packages even don’t need to be

recompiled.



Components Installer (setup)

IMPORTANT NOTE:

Make sure that Delphi/BCB/BDS IDE must be closed before installer is started.

Components Installer (setup) will guide trough process of installing components:

1. Copy all files into specified folder on local disk.

2. Add Library Paths (optional).

Setup file name indicate Next Suite version (nxcompsXX.exe, nxgridsXX.exe…).

Once setup is open, Component Wizard will appear:



Zip archive

Zip archive require zip utility program to be installed first. MS Windows XP and MS Windows Vista

operating systems already include support for zip archives.

Archive need to be extracted into desired folder with option “keep folder structure” is enabled inside

your zip utility program (WinZip, WinRar, Total Commander…).

When files are extracted, packages need to be installed within Delphi/BCB IDE.



2. Installing packages in IDE

Sections:

1 Library path Components Installer includes option to add Library Path on installation complete. If components are installed from zip archive, paths need to be added manually.

2 Compiling and installing packages Every package need to be compiled and installed.

3 Common problems during installation Problems may appear when installing packages, or when placing component on form.



Library path

Adding components paths into Library Path is required in order tell Delphi/BCB IDE where to find

components source files (.pas files).

IMPORTANT NOTE: Components Installer may automatically add Library Paths into IDE.

Library Path settings are located in:

Delphi 6, 7, BCB 6: Tools → Environment Options → Library → Library Path

Delphi 2005, 2006, 2007: Tools → Options → Environment Options → Delphi Options → Library – Win 32

Following Paths need to be added:

Path Components

<Next Suite>\Sources Required for all components

<Next Suite>\Sources\Next Grid NextGrid, NxFieldChooser, NxSlidesDesigner

<Next Suite>\Sources\Next DBGrid NextDBGrid

<Next Suite>\Sources\Next Inspector NextInspector, NextDBInspector

<Next Suite>\Sources\Next Collection NxAlertWindow, NxButton, NxFlipPanel, NxHeaderPanel…

<Next Suite>\Sources\Next Sheet NextSheet

<Next Suite>\Sources\Next Addons NxAutoCompletion, NxBusy, NxPreview, NxProgress…



Compiling and installing packages

IMPORTANT NOTE: Make sure that path to “Sources” sub-folder is added in Library Path before compiling and installing packages.

Components packages are located into “Packages\<IDE Version>” sub-folder in Next Suite folder:

Packages with suffix “Run” are run-time packages, packages with suffix “Dsgn” are design-time

packages.

Packages must be installed in following order (following table also indicate packages dependency).

Package Name Components

NxCommonRun.dpk1 Next Editors (NxEdit, NxSpinEdit, NxButtonEdit, NxDatePicker…), NxColorSheme. NxCommonDsgn.dpk

NxGridRun.dpk NextGrid, NxFieldChooser, NxSlidesDesigner

NxGridDsgn.dpk

NxDBGridRun.dpk NextDBGrid

NxDBGridDsgn.dpk

NxInspectorRun.dpk NextInspector, NextDBInspector

NxInspectorDsgn.dpk

NxCollectionRun.dpk NxAlertWindow, NxButton, NxFlipPanel, NxHeaderPanel… NxCollectionDsgn.dpk

NxSheetRun.dpk NextSheet, NxBorderPicker, NxLineStyleList

NxAddonsRun.dpk NxAutoCompletion, NxBusy, NxVirtualDataSet…

Open package, click on Compile2 and then (after compiling is finished) on Install:

1 Extension for C++ Builder packages is “.bpk”



Delphi 6, 7, BCB 6:

Delphi 2005, 2006, 2007:

Right-click on package:

As indicated in table above, NxCommonXXX.dpk packages are required to be installed before all other

packages because it contains some base classes used in other packages.

When packages are installed, following pages (categories) inside Components (Tool) Palette will appear:

Page (Category) Components

Next Suite3

Next Editors4

Next Collection

Next Shared

Next Add-ons

Version of particular components may be determined by reading Version property, or with right-clicking

on component and choosing “Version…” from component’s popup-menu:

2 “Build” in C++ Builder

3 Component list depends from purchased license

4 Included in every package



Common problems during installation

Problems may appear when installing packages, or when placing component on form.

What may cause installation problem?

Install problems usually appears when:

A. Previous version is not completely uninstalled. Symptoms:

1. Message “The procedure entry point @…” popup.

B. Package with same name installed in several IDEs are installed on system, and BPL files are build

into same folder.

Solutions

Follow these steps in order to successfully clean system from previous or invalid installation of Next

Suite components.

1. Remove components from IDE (Read bellow, Remove components from IDE)

2. Close IDE.

3. Delete every Nx*.bpl file from Delphi/BCB/BDS BPL sub-folder on your system:

Version Components

Delphi 6 <Next Suite>\Lib\Delphi 6

Delphi 7 <Next Suite>\Lib\Delphi 7

C++ Builder 6 C:\Program Files\Borland\CBuilder6\Projects\Bpl C:\Program Files\Borland\CBuilder6\Projects\Lib

Delphi 2005, Delphi 2006

C:\Documents and Settings\<User>\My Documents\Borland Studio Projects\Bpl

Delphi 2007 C:\Documents and Settings\<User>\My Documents\CodeGear Studio Projects\Bpl

4. Install packages again.

Direct support

If you still have problems installing components please contact us on [email protected] for direct

support.

mailto:[email protected]



3. Uninstalling old version

Uninstalling old version of Next Suite components is good choice when:

1. New version is installed after long period of not updating.

2. New major version is released.

3. Problems while installing occurs.

When uninstall is not required?

When some smaller bug-fix or new feature is added, there is no need for uninstall. In this situations re-

compiling target package is only required. Example: If new run-time method is added, or bug is fixed in

existing method in NextGrid component, only NextGrid’s run-time package need to be re-compiled.

Remove components from IDE

It is recommended that components are first removed (unregistered) from IDE:

1. Open Delphi/BCB IDE

2. Click on Components -> Install Packages

3. Remove every “Berg” package (Berg NextGrid, Berg NextGrid (Design), Berg Inspector…)

1. Click on package

2. Click on “Remove” button.

3. Repeat these steps for each “Berg” package.

4. Click on “OK” button.



Delete files from disk with using uninstaller

If previous version is installed with using Component Installer (setup), uninstall program need to be run

to delete components from system.

IMPORTANT NOTE: If components are installed from zip archive, uninstall program will not exist.

1. Close Delphi/ C++ Builder IDE

2. Run Uninstall.exe (located in “Next Suite” sub-folder, or inside Berg program group)

3. Follow on-screen instructions in order to uninstall components from system.

Delete files from disk with using file manager

If previous version is installed with from Zip archive, files need to be deleted from disk manually with

using Windows Explorer, or other file manager.

1. Close Delphi/C++ Builder IDE

2. Delete all files from NextSuite folder with using Windows Explorer, or other file manager.

If new version is going to be installed from zip file, it may be extracted into same folder after old files are

deleted. This will save time for adding new Library Paths into IDE.