[missing-sync-palmos-dev-talk] Minimum required changes to the example conduit

[Scott Gruby]

On Jul 20, 2005, at 1:22 AM, Dan Fletcher wrote:

> I have a conduit which works fine on my machine, and seems to work  
> fine on
> some of our customers machines. To develop this conduit I started  
> with the
> example conduit, and modified it.
>
> But, some users are reporting a clash with the MemoPad conduit.  
> When the
> Memopad conduit is installed, our conduit doesn't show up in the  
> Conduit
> dialog. If the Markspace memopad conduit is disabled though, then our
> conduit shows up!
>
> What are the minimum changes you need to make to the example MemoPad
> conduit to stop it clashing with the real MemoPad conduit? I'm not  
> talking
> about the actual syncing logic here, just any init calls, the  
> Info.plist
> file, etc.

1) First off, if you can, get your customers to use Missing Sync for  
Palm OS 4.0.6 b3 (the final one is coming in a few weeks) as some  
changes were made to the handling of MachO conduits (I don't think  
this applies to you as the change was for MachO conduits that weren't  
Cocoa).

2) You MUST rename the class and all classes in the conduit. This is  
a limitation of Cocoa's handling of dynamically loaded objects. Yes,  
it isn't ideal, but rename everything otherwise the wrong code will  
be executed. Cocoa doesn't handle namespace collisions well.

3) In ConduitInfo.plist, change CreatorID and Conduit Name

4) In Info.plist, change CFBundleExecutable to be your executable name.

5) In Info.plist, change NSPrincipalClass to be whatever you renamed  
the class to be.

If you still have problems after making these changes, please send me  
the conduit directly and we can work from there. We will have some  
updated sample code (not much has changed in the Cocoa sample) along  
with some whitepapers about conduit development and the transition to  
Intel next week in time for ADHOC.

I'm personally very excited to see a Cocoa conduit developed, so if  
there is anything we can do to help you promote your conduit, please  
don't hesitate to contact me.

Thanks.

--
Scott Gruby
Lead Engineer
Mark/Space, Inc.
<http://www.markspace.com/>

Please visit <http://www.markspace.com/support/> for assistance with  
Mark/Space products.