[missing-sync-palmos-dev-talk] Link Error

[Eric Shapiro]

On Mar 20, 2005, at 9:39 PM, Rich Burgis wrote:

> Second, my mental model of how things work is clearly lacking. Is 
> there anything beyond the white paper that describes how this whole 
> thing works? The MissingSync framework appears to address ObjectiveC 
> only. But is included in the Carbon sample and the other functions 
> clearly work, so it must be more than what I can see on the surface. 
> Before I added the call to the GetConduitName function the whole thing 
> worked even without the CDK libraries (At least not that I can find.)

By including the framework in a project, you get both the header file 
include paths AND the libraries you need. You shouldn't need anything 
beyond the framework.

>    ::GetConduitName( conduitName, sizeof( conduitName ) );
>
> This compiles nicely but will not link, stating that I have
>
> ld: Undefined symbols:
> _GetConduitName

GetConduitName isn't a call for you to make - it's a call for conduits 
to implement so that Hotsync or The Missing Sync knows what to display 
for its name. If I remember correctly, you implement 
CopyConduitNameAsCFStringRef() now instead for bundled conduits.

It's your conduit -- you should know the name. :-)

If you are writing a generic piece of code that will be used in 
multiple conduits, I suggest putting your name in your project's plist 
file or #define it in a header file.

The sample conduit (at least my old version) implements only 4 calls:
CopyConduitNameAsCFStringRef  - returns the conduit name so we know 
what to display
OpenConduitCarbon             - called when you should sync
CopyActionStringAsCFStringRef - returns a string, either "sync" or "do 
nothing"
ConfigureConduit              - puts up a dialog for your settings

Those are the calls you need to implement.

You should be able to make nearly any calls documented in Palm's Mac 
SDK documentation.

  -Eric

-----------------------------------------------
Eric Shapiro             eshapiro at markspace.com
-----------------------------------------------