[Tutorial] SketchUp Ruby C Extension

designingcrime

Hey guys, so I finally got a Ruby C extension to compile on both os x and windows and link curllib. I got a lot of help from Luis at the RubyInstaller group and ended up using RubyInstaller and DevKit to link curl and build using the gcc compiler included with devkit.
Here is the extension. Its a modified version of Dana's sketchup downloader, but also included uploading, basic http authentication and ssl certificate checking(all through curl). I provided instructions on how to build on both os x and windows.

https://github.com/sunglass/SunglassPlugins/tree/master/SG-SketchupHook/src/Connection%20Manager

Thanks for all your help guys.

Dana - Lets get your Sketchup downloader plugin working.

thomthom

@designingcrime said:

Hey guys, so I finally got a Ruby C extension to compile on both os x and windows and link curllib. I got a lot of help from Luis at the RubyInstaller group and ended up using RubyInstaller and DevKit to link curl and build using the gcc compiler included with devkit.
Here is the extension. Its a modified version of Dana's sketchup downloader, but also included uploading, basic http authentication and ssl certificate checking(all through curl). I provided instructions on how to build on both os x and windows.

https://github.com/sunglass/SunglassPlugins/tree/master/SG-SketchupHook/src/Connection%20Manager

Thanks for all your help guys.

Dana - Lets get your Sketchup downloader plugin working.

 :heart_eyes:

ishboo

That's awesome news! Congrats!

I'll have a look at it soon and try to finish up the tool

Anton_S

Lets, say I compile a HelloWorldEx on windows7, will it be the same as compiling it on XP?

Dan Rathbun

I would think it would depend upon which MSVC runtime you use.

Which ever you use, the user(s) will need to have that version installed on their machine(s), regardless of whether they are running Win5.1 (XP,) Win6.0 (Vista) or Win6.1 (Win7.)

SketchUp itself lists MSVC ver 8.x (2005) as a dependent assembly in it's manifest.

There ARE some programmers that have compiled extensions and linked to ver 10 (2010), but they must give the Microsoft download link to install that runtime version, and list it as a dependancy.

Reference:
http://en.wikipedia.org/wiki/Visual_C++

Anton_S

@dan rathbun said:

Which ever you use, the user(s) will need to have that version installed on their machine(s), regardless of whether they are running Win5.1 (XP,) Win6.0 (Vista) or Win6.1 (Win7.)

Hmm, I have win7 and windowns XP mode virtual pc, on the same comp.

Under Win6.1(win7), I recompiled win32/api.so to my own namespace with a name changed to win32/msp_api.so. ( MSPhysics::Win32::API)
It worked pretty well, until I've desided test it on WinXP mode virtual pc. WinXPmode had ruby-186-27, SU8, and some more raw programs, though it did not have MSVC.
Then, I started SU 8 and got this error:
msp_api.so without msft visual c++

Before I installed msvc 2010, I desided to test the native win32/api.so and seeing it working wasn't expected; Apperently the native win32/api.so worked pretty well, without showing any errors, and without msvc.

Being a little confused I desided to download msvc 2010 Redistributable Package (x86), to test whether my win32/msp_api.so would actually work on XPmode. After downloading, it worked now, but there was one question left: How did native win32/api.somanaged to work without msvc?

thomthom

@dan rathbun said:

There ARE some programmers that have compiled extensions and linked to ver 10 (2010), but they must give the Microsoft download link to install that runtime version, and list it as a dependancy.

No - you don't have to link to the runtime.
http://forums.sketchucation.com/viewtopic.php?f=180&t=41077&start=105#p411657

After a simple change in a compiler flag I could use the .so without the runtime installed.

Dan Rathbun

@anton_s said:

How did native win32/api.somanaged to work without msvc?

Because the SketchUp Installer installs MSVC 8.x (2005) runtime if it is not installed. The MSVC runtime install, might seem transparent to the user installing SketchUp, if they do not pay close attention.

Most XP machines will likely already have this older MSVC ".NET" runtime version installed if Automatic Windows Updates are turned ON.

Dan Rathbun

(Ruby-Talk GoogleGroup) Common Traps for C extensions

tomasz

I am trying to build the Basic sample under Xcode 4.4, but I am probably doing something wrong, because the resulting bundle fails to load into SU. I get "#<LoadError: myplugin.bundle Failed to load myplugin.bundle". I do not even get the "Failed to find init.. " error.

When compiling with extconf.rb and make the plugin loads just fine.

What project type should I start with to get the extension running? I have already tied /Framework/Bundle, Generic C++ Plug-in. How can I force the -flat_namespace in Xcode?

thomthom

I've never used XCode. :s
But if you find out, could you post back here? It'd be nice to include alternative setups.

Dan Rathbun

I am sure that I remember an old thread where someone explained how to do a OSX extension. I think they said you had to link it to the framworkized Ruby that is under the SketchUp app directory (not the system Ruby that Apple installs.) .. If I recall correctly, that is.

thomthom

I didn't have to relink anything. But I'm not familiar with his scenario of XCode 4.4.

Dan Rathbun

I'll have to find the old topic.

Is v4.4 too new to work with such an old Ruby version as 1.8.5-p0 ??

thomthom

Dunno - what OS are we talking about?

I've only done this on OSX 10.4 and 10.5. Maybe the Ruby that shipped there was compatible with SketchUp's Ruby - and this new version isn't and might actually require you to link to SketchUp's libs? I'm just taking a stab in the dark here.

Jim

@dan rathbun said:

(Ruby-Talk GoogleGroup) Common Traps for C extensions

[off:i2j9ll26]I prefer this interface to the Ruby forum:

http://www.ruby-forum.com/topic/4405289

I just don't care for the Google groups interface.[/off:i2j9ll26]

tomasz

@dan rathbun said:

I'll have to find the old topic.

Is v4.4 too new to work with such an old Ruby version as 1.8.5-p0 ??

I don't think so.

The "make" command uses same complier that is bundled with XCode , that is LLVM GCC 4.2.
When the extension is compiled this way, it works fine in SU. It looks like it is just a matter of placing correct settings in proper Xcode windows.

The "-dynamic -bundle -flat_namespace " flags go to 'Linker/Other Linker Flags'. I have chosen STL C++ Library template ... which produces a C++ dynamic shared library (.dylib). I guess it is right type. Unfortunately it does not load with require "extension". Something is still missing.

thomthom

@unknownuser said:

I have chosen STL C++ Library template ... which produces a C++ dynamic shared library

Wait, are you making a C++ extension instead of C?

I've seen some people making Ruby extensions in C++, but you need to perform some extra steps. Something like extern "C".

http://rice.rubyforge.org/
http://www.ruby-forum.com/topic/128668
https://www.google.com/search?hl=en&client=firefox-a&hs=LXd&rls=org.mozilla:en-US:official&q=+site:ruby-forum.com+ruby+c+extension+c%2B%2B&sa=X&ei=7zJXUK62LvLV4QTAvIGgCQ&ved=0CFMQrQIwAw&biw=1600&bih=1096

Dan Rathbun

@unknownuser said:

I have chosen STL C++ Library template ... which produces a C++ dynamic shared library (.dylib). I guess it is right type. Unfortunately it does not load with require "extension". Something is still missing.

It should according to the description of Kernel.require()

(1) Try the whole filename: require("extension.dylib")

(2) Try specifying Kernel.require("extension_name") instead of the copy of require() that is inherited by Object. (Some naughty plugin could have changed it.)

(3) Be aware that require has undergone changes over the years, to both fix some bugs (early on it pushed filepaths into $LOADED_FEATURES before it was determined if the files loaded successfully,) and to change the iteration of paths in $LOAD_PATH (it used to iterate the $LOAD_PATH array multiple times for each filtype { .rb, .so, .o, .dll, ...etc.} This was changed later on so it only iterates each directory once.) One of the major SNAFUs with dealing with different Ruby versions for different SketchUp platforms and versions.

(4) require() has ALWAYS first checked to see if the argument resolves to a valid absolute filepath, and loads that valid file, instead of iterating through the $LOAD_PATH array.

tomasz

@thomthom said:

Wait, are you making a C++ extension instead of C?

Yes. I have finally made it. What a nightmare

Xcode

New Project

Template > "Command Line Tool"!

Enter product name "SX_HelloWorld.bundle"

Type "C++"

The *.c file renamed to *.cpp.
Init_SX_HelloWorld( void ) has to be enclosed in extern "C"

extern "C" {
// The init function here
}

The last line of the code should read:

rb_define_module_function( mSUExtTest, "knock_knock", RUBY_METHOD_FUNC(rb_knock), 0 );

Now the important thing

Build Settings\Linking\Other Linker Flags > -dynamic -bundle -undefined suppress -flat_namespace

Build Settings\Search Paths\Header Search Path > has to point to Ruby headers
Build Settings\Search Paths\Library Search Path > has to point to Ruby compiled library

I have compiled the extension with LLVM GCC 4.2