May 9, 2012
If the LastErrorText contains a line such as this:
socketError: Permission denied
It means you need to add permissions for Internet communications in your manifest. It should be placed outside of the application tag, such as:
<manifest>
<application>
.
.
.
</application>
<uses-permission android:name="android.permission.INTERNET" />
</manifest>
April 18, 2012
Chilkat v9.3.1 is in the process of being released this week. The release notes (below) detail the changes, fixes, new features, etc. regarding the new version.
xmlStr = http.S3_ListBucketObjects("ChilkatABC?max-keys=2000&marker=xyz")
The S3_ListBucketObjects method recognized all params listed in the AWS documentation for listing objects in a bucket: delimiter, marker, max-keys, and prefix. See Amazon’s AWS online documentation for more information.
Xml *Xmp::GetProperty(Xml *xml, String *propName)
This was added to provide the ability to handle “Property Qualifiers”. (see http://www.aiim.org/documents/standards/xmpspecification.pdf )
Property Qualifiers
Any individual property value may have other properties attached to it; these attached
properties are called property qualifiers. They are in effect “properties of properties”; they can
provide additional information about the property value. For example, a digital resource
representing a musical production might have one or more authors, specified using the
dc:creator property, which is an array (see the figure below). Each array value might have a
property qualifier called role, which could take a value of “composer” or “lyricist” or
possibly other values.NOTE: At this time, only simple properties may have qualifiers, and the qualifiers themselves
must be simple values (not structures or arrays). This is because of limitations in early
versions of the Adobe XMP Toolkit.
To handle the situation, a new method named GetProperty was added. It returns the Xml node for the property. The Chilkat XML API can then be used to get the attributes.
New property: int NumReceivedClientCerts New method: Chilkat.Cert *GetReceivedClientCert(int index)
A few notes:
The ConnectOnly will establish the connection and do nothing else. This allows your application to fetch the server’s SSL cert via the GetSslServerCert method. If the cert is verified to be OK, then then LoginAfterConnectOnly may be called to authenticate. The combination of calling ConnectOnly followed by LoginAfterConnectOnly is equivalent to calling the Connect method.
Regarding Objective-C programming for MAC OS X and IOS:
(from https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/MemoryMgmt/Articles/mmAutoreleasePools.html )
Cocoa always expects there to be an autorelease pool available. If a pool is not available, autoreleased objects do not get released and your application leaks memory. If you send an autorelease message when a pool is not available, Cocoa logs a suitable error message. The AppKit and UIKit frameworks automatically create a pool at the beginning of each event-loop iteration, such as a mouse down event or a tap, and drain it at the end. Therefore you typically do not have to create a pool, or even see the code that is used to create one. There are, however, three occasions when you might use your own autorelease pools:
If you are writing a program that is not based on a UI framework, such as a command-line tool.
If you write a loop that creates many temporary objects.
You may create an autorelease pool inside the loop to dispose of those objects before the next iteration. Using an autorelease pool in the loop helps to reduce the maximum memory footprint of the application.
If you spawn a secondary thread.
You must create your own autorelease pool as soon as the thread begins executing; otherwise, your application will leak objects. (See “Autorelease Pools and Threads” for details.)
April 13, 2012
The Chilkat C/C++ libs are (internally) written in C++. Therefore, when linking a “C” program with the Chilkat libs, the C++ runtime libs must be included. This is true regardless of the operating system, whether it be Windows, MAC OS X, IOS, Linux, etc. Different build environments will have different ways of accomplishing the task. For example, with XCode (on Mac OS X), simply adding an empty source file having a filename with the extension “.cpp” is all that is needed. This blog post will show how to link a “C” program on Linux with the Chilkat C/C++ static library. The solution is to use “g++” for the link phase instead of “gcc”. The telltale indicator that the C++ runtime libs are missing is when you see errors involving “__cxxabiv1″, such as the following:
undefined reference to `vtable for __cxxabiv1::__class_type_info'
Here is a simple C program with a simple shell script to build it correctly.
buildTest.sh (This is for 64-bit Linux. Notice that g++ is used for linking, not gcc.)
#!/bin/bash -ev
gcc -m64 -Werror -c -fmessage-length=0 -fno-stack-protector -fPIC -o"cTest.o" "cTest.c"
g++ -g0 -m64 -L"/home/chilkat/workspace/chilkat/lib64_static" ./cTest.o -o"cTest"
-lchilkat-9.3.0 -lpthread -lresolv
cTest.c
#include <stdio.h>
#include "../chilkat/include/C_CkFtp2.h"
void testFtp2Create(void)
{
HCkFtp2 ftp;
BOOL success;
ftp = CkFtp2_Create();
// Any string unlocks the component for the 1st 30-days.
success = CkFtp2_UnlockComponent(ftp,"Anything for 30-day trial");
if (success != TRUE) {
printf("%s\n",CkFtp2_lastErrorText(ftp));
}
CkFtp2_Dispose(ftp);
}
int main(int argc, char *argv[])
{
testFtp2Create();
printf(”Hello World!\n”);
return 0;
}
March 16, 2012
Question: Will using Chilkat (for IOS) prevent my app from being accepted into the Apple App Store?
Answer: Using the Chilkat libs for IOS does not prevent it from being accepted in the Apple App Store. For reference, the following app uses Chilkat and was accepted into the app store on 14-March-2012.
March 15, 2012
Question:
In C++, is it somehow possible to specify a desired charset (like ISO-8859-15) when getting mail headers with POP3?
Answer:
Instead of calling the method that returns a “const char *” — which can return either utf-8 or ANSI (see this Chilkat blog post about the Utf8 property common to all Chilkat C++ classes), call the alternate method that returns the string in a CkString object. You can then get the iso-8859-15 string from the CkString object.
Each Chilkat C++ method that returns a string has two versions — an upper-case version that returns the string in a CkString (always the last argument), and a lower-case version that returns a “const char *”.
For example, in the CkEmail class:
bool GetHeaderField(const char *fieldName, CkString &outFieldValue); const char *getHeaderField(const char *fieldName);
The lower-case method returning a “const char *” returns a pointer to memory that may be overwritten in subsequent calls. Therefore, make sure to copy the string to a safe place immediately before making additional calls on the same Chilkat object instance. (Only methods that also return “const char *” would overwrite the memory from a previous call.)
The upper-case version of the method returns the string in a CkString object. It is an output-only argument, meaning that the CkString contents are replaced, not appended. To get the iso-8859-15 string from the CkString, call the getEnc method. For example:
const char *str_iso_8859_15 = outFieldValue.getEnc("iso-8859-15");
This returns a NULL-terminated string where each character is represented as a single byte using the iso-8859-15 encoding.
March 13, 2012
Clarification on the acronyms “SFTP” and “FTPS”
“SFTP” is the Secure File Transfer Protocol over SSH. It is a protocol unrelated to the FTP protocol. (It is actually a subsystem of SSH.) The Chilkat SSH / SFTP component is used for “SFTP”. SFTP is achieved by connecting to an SSH server at port 22.
On the other hand, the Chilkat FTP2 component is for FTP. FTP servers listen at port 21 (non-SSL/TLS) and port 990 (SSL). FTP over SSL (i.e. port 990) is called “FTPS”.
March 8, 2012
Question:
Answer:
Yes, it can unzip files w/ Unicode names — assuming the .zip was correctly created. Your first test should be to unzip without trying anything differently. Check to see if the files are created w/ the correct filenames. If not, try setting the zip.OemCodePage property = 65001 (for utf-8), then re-try. If that doesn’t work, it may be that the .zip was created such that the filenames are embedded using a specific charset. You would need to set the OemCodePage property to match that charset. See this: http://www.chilkatsoft.com/p/p_453.asp
March 1, 2012
The Chilkat SshTunnel object/class (may be “CkSshTunnel” in some programming languages) provides a number of properties to help in debugging (i.e. understanding) what is happening in the background thread:
February 28, 2012
Some Chilkat ActiveX functions return binary data as a Variant containing a byte array. If the Chilkat function fails, it returns an OleVariant containing an empty byte array. The following code snippet is incorrect and will cause Delphi to raise an EVariantBadIndexError exception if an empty OleVariant is returned.
// This is incorrect: mybuffer : array of byte; // ... // Do not directly assign a variable declared as "array of byte" to the OleVariant returned // by the Chilkat function. mybuffer := socket.ReceiveBytes();
The correct technique is to do the following:
myVariant: OleVariant;
myByteArray : array of byte;
uBound : Integer;
numBytes : Integer;
// ....
myVariant := socket.ReceiveBytes();
// Check the upper bound of the array contained within the Variant.
// If it equals -1, then it is empty which means the Chilkat function call failed.
uBound := VarArrayHighBound( myVariant, 1 );
if (uBound < 0) then
begin
Memo1.Lines.Add(socket.LastErrorText);
Exit;
end;
// The number of bytes in the byte array equals uBound+1
numBytes := uBound+1;
// Now that we know the variant is non-empty, it is safe to access it as an "array of byte"
myByteArray := myVariant;