[转]WHAT IS PBORCA.EXE ?
上一篇 / 下一篇 2009-08-14 09:49:54 / 个人分类：PB开发
此文转载于http://dm.char.com.ua/pb/pborca.htm
WHAT IS PBORCA.EXE ?- it is a free tool to compile Powerbuilder projects and to manage objects in PBL libraries.
*.ORCfiles - it's a special scripts to do it.
Download Old ANSI version:pborcaA.rarversion (YMD)2005-01-13
Download New UNICODE+ANSI version:pborcaW.rarversion (YMD)2007-08-08
Package contents
| install.cmd | installation script. copiespborca.exetowindows\system32directory and importspborca.reginto your registry |
|---|---|
| pborca.exe | A unicode tool to execute orca scripts (*.orc) |
| pborcaa.exe | An ansi tool to execute orca scripts (*.orc) |
| pborca.htm | this file |
| example.orc | contains allorca scriptcommands with explanations. |
| pborca.reg | windows registry modification to support context menu for*.orcfiles |
You can useinstall.cmdto install this tool on your computer.
After installation you'll have a special context menu in the explorer for*.orcfiles:
| Edit Script | opens selected orca script. usingnotepad |
| Run Script | executes all commands from the selectedorca scriptusingpborca.exe |
NOTE :To use this tool you have to set yourpathenvironment variable to PowerBuilder shared files.
Rools of the ORCA SCRIPT
One command - one line.
Comma - is delimiter for parameters of the command.
# at the begining of the line designate all text on the line as a comment.
%- is a meta. symbol.
the following meta. symbols are supported:
Some parameters are optional and could be omitted. In this help they are quoted with []:%n New line %r Carriage return %t Tab %, Comma %% % combination with any other symbol - returns symbol itself
regenerate[pblName], [itemName], [itemType]
If a parameter is omitted, you must specify coma in any case. Example:
#regenerate all windows in test.pbl
regeneratetest.pbl, , win
#regenerate all objects named "main" in test.pbl
regeneratetest.pbl, main,
#regenerate all objects in test.pbl
regeneratetest.pbl, ,
#regenerate all objects in all libraries from the current library list
regenerate, ,
The command parameters could contain environment variables:
#create library my.pbl in %TMP% directory
library create%%TMP%%\my.pbl ,
You can pass variables as parameters to pborca.exe :
pborca.exe -Dsrcdir=c:\projects\TestSvn -Ddstdir=c:\projects\TestPb
In script. you can access these new variables:
#import c:\projects\TestSvn\myObject.sru into c:\projects\TestPb\myLib.pbl
import%%SRCDIR%%\myObject.sru , %%DSTDIR%%\myLib.pbl
SUPPORTED ORCA COMMANDS
| session beginpbOrcDll | Starts orca session. The new parameterpbOrcDlldefines which PowerBuilder version you are going to use during this session. This library appears in the PowerBuilderSharedfolder. The name of this library ispborcXX.dll, where XX is version of PowerBuilder. For example:
session beginpborc70.dll Note: current version of PBORCA.exe does not support unicode versions of PB | ||||||||||||
| copy itempblSrc, [entryName], [entryType], pblDst | copies object(s) from librarypblSrctopblDst. entryNameor/andentryTypecould be omitted for all objects. entryType: app, dw, fn, menu, query, struct, uo, pipe, proxy, or win. pblSrccan contain wildcard characters (* and ?). Note: this command overwrites item in the destination library. | ||||||||||||
| library createpblName, [comments] | creates a new librarypblNamewithcomments | ||||||||||||
| set liblist begin | Special command to begin library list enumeration. After this command, every line is a pbl library name. There could be comments within the library list. Optionally you can specify parameters of PBL compilation (used only forbuild execommand). The format of library list item is: pblName[;] [, isPBD [, pbrName] ] Where: pblNameis a library name. It can contain ';' at the end (like in PB library list) isPBDspecifies a way to build this library. Use value1to build PBD/DLL for this library, or0to include it into executable. If this option is omitted then default value used = 1. pbrNamedefines a resource file for thepblName. You can't specifypbrNameifisPBD=0. #Usage example: set liblist begin #do not compile test1.pbl into separate PBD/DLL test1.pbl , 0 #compile test2.pbl into separate PBD/DLL and use test2.pbr resource file test2.pbl , 1, test2.pbr #compile test3.pbl into separate PBD/DLL (default behavior) test3.pbl set liblist end | ||||||||||||
| set liblist end | Special command to end library list enumeration. | ||||||||||||
| set applicationpblName, applicationName | Sets current applicationapplicationName. The parameterpblNamedefines name of the application library. If both parameters ommited, ORCA will set up an internal default application as current application (usefull to create(import) a new application). | ||||||||||||
| build appbuildType | Compiles all the objects in the libraries included on the library list. If necessary, the compilation is done in multiple passes to resolve circular dependencies. buildType:fullorincrementalormigrate. | ||||||||||||
| build exeexeName, iconName, pbrName, codeType | Creates a PowerBuilder executable withcodeType=pcode orcodeType=machinecode. Note: before creating executable you must delete the fileexeNameif it exists. | ||||||||||||
| build librarypblName, [pbrName], type | Creates a separated PowerBuilder dynamic library withtype=pbd ortype=dll. Note: To build all libraries+executable usebuild execommand. | ||||||||||||
| delete itempblName, entryName, entryType | Deletes a PowerBuilder library entryentryNameof typeentryTypefrom librarypblName. | ||||||||||||
| delete duplexprimaryLib, deleteFromLib | Deletes objects fromdeleteFromLibthat found in theprimaryLib. | ||||||||||||
| regenerate[pblName], [itemName], [itemType] | Compiles an objectitemNameof typeitemTypein a PowerBuilder librarypblName. TheitemNameand/oritemTypecould be omitted, then the parameter will be ignored. IfpblNameis omitted then regeneration will be done for all libraries from the library list. Note: you should set library list and application, to make regeneration correctly. | ||||||||||||
| regenerateall | Compiles (regenerates) each object from the library list while there are compilation errors. This command was created specially for use after importing the whole project from source files. During rebuild ( full or migrate ) pborca can crash. In this case use this command. Note: you should set library list and application, to make regeneration correctly. | ||||||||||||
| exportpblName, [itemName], [itemType], directory | Exports object(s) defined byitemNameanditemTypefrom a librarypblNameto a destinationdirectory. TheitemNameand/oritemTypecould be omitted, then the parameter will be ignored. ThepblNamecan contain wildcard characters (* and ?). For unicode version only HEXASCII export type implemented. | ||||||||||||
| importexportedFile, dstLibrary | Imports previously exported object(s) fromexportedFileintodstLibrary. Ignores all compilation errors. You must set application before calling this function. If it's a new application, you must set default application by calling set application , without any parameters. After whole application import you must callbuild app migrate. TheexportedFilecan contain wildcard characters (* and ?). #Usage example: import*.sr?, temp\work.pbl For unicode version only HEXASCII, ASCII, and UNICODE file types are supported. | ||||||||||||
| import moveexportedFile, dstLibrary | The same asimportbut after executionexportedFilewill be deleted from your disk. | ||||||||||||
| import moveokexportedFile, dstLibrary | The same asimport movebut after executionexportedFilewill be deleted from your disk only if import was done without any errors. | ||||||||||||
| import pbg2pblpbgFile, dstFolder | Imports all objects specified in thepbgFileinto corresponding pbl file located indstFolder pbgFilecould contain wildcard symbols.dstFolderis a path where PBLs must be located. Libraries must exist and present in the library list. | ||||||||||||
| import pbg2pbl anypbgFile, dstFolder | The same asimport pbg2pblbut skips pbg and source files if they are not exists. | ||||||||||||
| syssys_command | Executes system command defined bysys_command. | ||||||||||||
| echotext | Displaystextmessagee. | ||||||||||||
| timestamp | displays current date and time. | ||||||||||||
| target create libpbtFile | creates powerbuilder libraries that are specified in the target filepbtFile. Libraries will be located in the relative path topbtFile. Note: target should contain only relative paths for libraries! | ||||||||||||
| target importpbtFile, sourceDir | For each library specified inpbtFile, opens corresponding pbg file insourceDir, and imports all the objects from thesourceDirfor each pbg into a library that is located nearpbtFile. Note: Before this command you have to set library list and application. | ||||||||||||
| target import anypbtFile, sourceDir | The same astarget importbut skips pbg and source files if they are not exists. | ||||||||||||
| target set apppbtFile | Sets current application specified inpbtFile. See:set applicationcommand. | ||||||||||||
| target set liblistpbtFile | Sets library list specified inpbtFile. | ||||||||||||
| session end | ends orca session. |
导入论坛 引用链接 收藏 分享给好友 推荐到圈子 管理 举报
TAG:
