paclient.exe, the Platform Assistant Client Application
Go Up to Command-Line Utilities Index
paclient.exe is a command-line client for the Platform Assistant server.
You need to install and run the Platform Assistant server on the target machine to run or debug an application for 64-bit Windows (when the development PC is 32-bit Windows), macOS or iOS, as well as to run or debug any Windows application remotely or to deploy an application for Windows, macOS, or iOS.
When the target platform is iOS, the target machine is macOS.
You do not need to install or run the Platform Assistant server to run, debug, or deploy an application for Android because paclient.exe runs on the developer machine and invokes the Android SDK tools already installed on the same computer. paclient.exe is part of the product installation on the development PC.
If you use the IDE instead of command line utilities, you do not need to use paclient.exe.
You can find the paclient.exe application in C:\Program Files (x86)\Embarcadero\Studio\22.0\bin.
Contents
Example
The following command deletes files from the server installation on an macOS remote target platform that has IP address 10.20.10.206. The command deletes all files related to MyOldRemoteProfile. The ./ (dot-slash) indicates that the directory list is relative to the directory where paserver is installed on the target platform, and ** means that all subdirectories are searched:
> paclient --host=10.20.10.206 --Remove=./**/* MyOldRemoteProfile
Command-Line Help
Here is the command-line help for paclient.exe:
> paclient.exe -?
Platform Assistant Client
Copyright (c) 2010-2021 Embarcadero Technologies, Inc.
Usage: paclient [<options>] ProfileName
where <options> include
-h<name> or --host=<name>
Specify the name or IP address of the remote/host machine running the
Platform Assistant Server
-p<number> or --port=<number>
Specify the port the Platform Assistant Server is configured for. Default
to 64211
-m<platform> or --platform=<platform>
Specify the target platform. Possible values are "Win32", "OSX64",
"Win64", "Linux64"
-a<file/dir> or --add=<file/dir>
Add file/dir to the list of items to be cached. You may specify multiple
file/dir separated with ';'. You may also use this option more than once.
File/dir can include wildcard characters (e.g. --add=c:\abc\**\*.* where
** indicates to include all sub-directories of abc)
-ai<file/dir> or --addinclude=<file/dir>
Add include file/dir to the list of items to be cached. You may specify
multiple file/dir separated with ';'. You may also use this option
more than once.
File/dir can include wildcard characters (e.g. --addinclude=c:\abc\**\*.*
where ** indicates to include all sub-directories of abc)
-al<file/dir> or --addlibrary=<file/dir>
Add library file/dir to the list of items to be cached. You may specify
multiple file/dir separated with ';'. You may also use this option more
than once.
File/dir can include wildcard characters (e.g. --addlibrary=c:\abc\**\*.*
where ** indicates to include all sub-directories of abc)
-af<dir>[,*] or --addframework=<dir>[,*]
Add framework files to the list of items to be cached. You may specify
multiple dir separated with ';'. You may also use this option more than
once
-g<file/dir>[,<destdir>] or --get=<file/dir>[,<destdir>]
Copy file/dir from the remote/host machine running the Platform Assistant
Server. You may specify multiple file/dir,destdir separated with ';'.
You may also use this option more than once.
File/dir can include wildcard characters (e.g. --get=c:\abc\**\*.* where
** indicates to include all sub-directories of abc)
-u<file/dir>[,<destdir>][,<flags>][,<destname>] or
--put=<file/dir>[,<destdir>][,<flags>][,<destname>]
Copy file/dir to the remote/host machine running the Platform Assistant
Server. You may specify multiple file/dir,destdir,flag,destname separated
with ';'. You may also use this option more than once. Possible flags
values are "0", "1", "2", "3", "5" where 0 for normal file, 1 for
runnable file, 2 for archive file, 3 for executable file, and 5 for
script file.
File/dir can include wildcard characters (e.g. --put=c:\abc\**\*.* where
** indicates to include all sub-directories of abc)
-U<file>[,<destdir>][,<destname>] or --Put=<file>[,<destdir>][,<destname>]
Copy file on the remote/host machine running the Platform Assistant
Server. You may specify multiple file/dir,destdir,destname separated
with ';'. You may also use this option more than once.
-r<file/dir> or --remove=<file/dir>
Remove file/dir from the list of items to be cached locally. You may
specify multiple file/dir separated with ';'. You may also use this
option more than once.
File/dir can include wildcard characters (e.g. --remove=c:\abc\**\*.*
where ** indicates to include all sub-directories of abc)
-R<file/dir> or --Remove=<file/dir>
Remove file/dir from the remote/host machine running the Platform
Assistant Server. You may specify multiple file/dir separated with ';'.
You may also use this option more than once.
File/dir can include wildcard characters (e.g. --Remove=c:\abc\**\*.*
where ** indicates to include all sub-directories of abc)
-C<dir>,<listfile> or --Clean=<dir>,<listfile>
Remove files in directory and all sub-directories of <dir> that are
not listed in file <listfile> from the remote/host machine running the
Platform Assistant Server. You may use this option more than once
-l or --local
Update and display information about the specified Profile without
initiating a connection to the Platform Assistant Server
-s<dir> or --sysroot=<dir>
Indicate the local directory where the remote files will be cached.
Default to %USERPROFILE%\Documents\RAD Studio\Profiles\<ProfileName>
-t<number> or --timeout=<number>
Specify the timeout in seconds when connecting to the Platform Assistant
Server. Default to 0 second
-e<number> or --error=<number>
Stop copy after n errors. Default to 20 errors
-k or --keep
Keep files whose source time is different than the destination time
-pw<text> or --password=<text>
Specify the login password for the Platform Assistant Server
-pk<text> or --passkey=<text>
Specify the login password (encrypted) for the Platform Assistant Server
-pf<file> or --passfile=<file>
Specify the login passfile for the Platform Assistant Server
-c<path>,<certificate>[,<entitlement>] or
--codesign=<path>,<certificate>[,<entitlement> [,1]]
CodeSign application with certificate on the remote machine running the
Platform Assistant Server. If '1' is specified, application
notarization options will be applied
-i<path>,<outpath>,<certificate>,<profile>,<type> or
--ipa=<path>,<outpath>,<certificate>,<profile>,<type>
Create application .ipa file with certificate and provisioning profile
on the remote machine running the Platform Assistant Server. Possible
type values are "1", "2" where 1 for ad-hoc and 2 for app-store
-ii<path>,<deviceid> or --installipa=<path>,<deviceid>
Install .ipa file in the device on the remote machine running the
Platform Assistant Server
-pb<path>,<installpath>,<outpath>,<certificate> or
--productbuild=<path>,<installpath>,<outpath>,<certificate>
Create application .pkg file with certificate on the remote machine
running the Platform Assistant Server
-dc<javapath>,<toolpath>,<basepath>,<jarpath>,<dexpath>[,<classpathlistpath>] or
--dexcompile=<javapath>,<toolpath>,<basepath>,<jarpath>,<dexpath>[,<classpathlistpath>
Transform a .jar file into a .dex one
-dm<javapath>,<toolpath>,<classdir>,<inputlistpath> or
--dexmerge=<javapath>,<toolpath>,<classdir>,<inputlistpath>
Merge .dex files
-ap<sdkpath>,<srcdir>,[<classdir>],[<resdir>],[<assetdir>],<manifest>
,<basepath>,<outpath>[,<debug>] or
--aaptpackage=<sdkpath>,<srcdir>,[<classdir>],[<resdir>],[<assetdir>]
,<manifest>,<basepath>,<outpath>[,<debug>]
Create application .apk file from files in the specified srcdir
-ab<javapath>,<aapt2path>,<bundletoolpath>,<srcdir>,[<classdir>],[<resdir>]
,[<assetdir>],<manifest>,<basepath>,<outpath> or
--appbundle=<javapath>,<aapt2path>,<bundletoolpath>,<srcdir>,[<classdir>]
,[<resdir>],[<assetdir>],<manifest>,<basepath>,<outpath>
Create application .aab file from files in the specified srcdir
-j<sdkpath>,<path>,<alias>,<keystore>,[<sign>],[<digest>],<storepass>
,<keypass> or
--jarsign=<sdkpath>,<path>,<alias>,<keystore>,[<sign>],[<digest>],<storepass>
,<keypass>
JarSign application .aab file with the specified keystore
-as<javapath>,<toolpath>,<path>,<alias>,<keystore>,<storepass>,<keypass> or
--apksign=<javapath>,<toolpath>,<path>,<alias>,<keystore>,<storepass>,<keypass>
ApkSign application .apk file with the specified keystore
-z<sdkpath>,<path>,<outpath>[,<size>] or
--zipalign=<sdkpath>,<path>,<outpath>[,<size>]
Align application with the specified alignment size. Default to 4
-sd<sdkpath>,<path>[,<outpath>] or --stripdebug=<sdkpath>,<path>[,<outpath>]
Remove all debugging symbols
-un<path1>,<path2>,<outpath> or --universal=<path1>,<path2>,<outpath>[,1]
Create multi architecture file on the remote machine running the
Platform Assistant Server. If '1' is not specified, <path1> and <path2>
will be removed
-u8 or --utf8encode
Write error and output text in UTF8 format
-v or --verbose
Print out the files processed
-up<makeappxpath>,<package>,<mapfile> or
--uwppackaging=<makeappxpath>,<package>,<mapfile>
Create Universal Windows Platform package, .msix file, using files
listed in the mapfile
-us<signtoolpath>,<package>,<certificate>,[<password>],<digest> or
--uwpsigning=<signtoolpath>,<package>,<certificate>,[<password>],<digest>
Sign Universal Windows Platform package with the specified certificate
-pp<bundleid>,<certificate>,<profile>,<type> or
--provisioningprofile=<bundleid>,<certificate>,<profile>,<type>
Verify if bundleid, certificate and type are valid for the specified
provisioning profile found on the remote machine running the Platform
Assistant Server. Possible type values are "1", "2" where 1 for ad-hoc
and 2 for app-store
-na<path>,<bundleid>,<username>,<password> or
--notarizeapp=<path>,<bundleid>,<username>,<password>
Notarize the application on the remote machine running the Platform
Assistant Server
-ni<UUID>,<username>,<password> or
--notarizationinfo=<UUID>,<username>,<password>
Get the status of the notarization request on the remote machine
running the Platform Assistant Server
-sa<path>,<outpath> or --stapleapp=<path>,<outpath>
Attach a ticket to the notarized application on the remote machine
running the Platform Assistant Server
-ac<path>,<outpath> or --assetcatalog=<path>,<outpath>
Compile an asset catalog document into Assets.car on the remote
machine running the Platform Assistant Server
-sb<path>,<outpath> or --storyboard=<path>,<outpath>
Compile storyboard document into a file that can be loaded at runtime
on the remote machine running the Platform Assistant Server
-? or --help
Print this help screen