Repo tutorials do not match online tutorials. One or the other is behind.

The repo has one more example than online, and two more tutorials than online developer site.

Ref: http://developer.sketchup.com/en/content/tutorials

Need help. I don't know what is wrong. require "extensions.rb" cant find the file. But require "sketchup.rb" is right.

Based on these threads by @NeilBurkholder

https://forums.sketchup.com/t/setting-up-netbeans-with-sketchup-intellisense-and-debugging/38633

https://forums.sketchup.com/t/ruby-code-editor-of-choice/38312

This is a quite old repo and there seems to be a lot of things we could look over in a general clean up. Here are a few points.

• Consider merging tutorials and examples so we don't repeat ourselves and have two code bases to maintain.
• Clarify what would map to an actual extension project. For instance, write a comment in the loader script telling it is a utility and not a part of the actual extensions. Getting this overview can be very difficult for new coders.
• Consider wrapping the source for each extension in a src folder. I think rubocop-sketchup assumes such a folder, and it's a good practice to separate your source from "project meta" files like readme.
• Clarify "tut" and "ex" prefix in file names. Prefer fully spelled out "tutorial" and "example".
• Style Ruby for readability (after we've come up with a good RuboCop config).
• Change Trimble Navigation to Trimble Inc in copyright notices.
• Prefer inline Ruby load guard using instance variables over sketchup.rb methods.
• Consider changing 99 to some other number for examples.

If you copy paste (which some people will definitely do instead of going to the GH repo) the two code samples from:

• http://developer.sketchup.com/en/content/hello-cube-2
• http://developer.sketchup.com/en/content/tuthellocubemainrb

and infer file paths to create from the text on those pages, you end up with

• tut_hello_cube.rb
• tut_hello_cube/main.rb

That meshes poorly with line 8 in the loader script there, which references the directory ex_hello_cube:

ex = SketchupExtension.new('Hello Cube', 'ex_hello_cube/main')

Presumably this is related to #2, but seems more immediately problematic because the live example is broken as written.

README typo in Using way (2), viz:
section
How Do I Use These Tutorials?

2. ... Get the code right on your machine, will all the comments for easy access.
   should be:
3. ... Get the code right on your machine, with all the comments for easy access.

This error also propagated to the online introduction, at:
http://developer.sketchup.com/en/content/tutorials

I use testup-2

rubymine can start sketchup,but it can't connect the port of debug.BreakPoint doesn't work.

I want to use the rubymine to debug sketchup, but I can not find this file " Where can I find this file ", need help.
thankyou

Hi, I've tried to set task.json as below, but it doesn't work.
{ // See https://go.microsoft.com/fwlink/?LinkId=733558 // for the documentation about the tasks.json format "version": "2.0.0", "tasks": [ { "label": "Debug SketchUp 2019", "type": "shell", "command": "open -a '/Applications/SketchUp 2019/SketchUp.app' --args -rdebug 'ide port=7000'", "windows": { "command": "&'C:/Program Files/SketchUp/SketchUp 2019/SketchUp.exe' -rdebug 'ide port=7000'" } } ] }

The TERMINAL prompts the error:
`Executing task: &'C:/Program Files/SketchUp/SketchUp 2019/SketchUp.exe' -rdebug 'ide port=7000' <

& was unexpected at this time.
The terminal process terminated with exit code: 1`

I remove the '&' or change the '/' to '\'， still not make any sense.
I really need your help!

https://forums.sketchup.com/t/how-do-textures-work/47943/4?u=thomthom

http://ruby.sketchup.com/Sketchup/Face.html#get_UVHelper-instance_method

hello, sketchup.

I sometimes use sketchup ruby api.

When I tried to access an empty group after pushpull a face in active_model.active_entities, I couldn't access the group because it already has deleted. Sketchup::Face.pushpull method only deletes empty groups in active_model.active_entities.

I can use non-empty-group to avoid this issue, but I just want to know the reason why pushpull destroys empty groups.

thank you.

Hi,

I tried to setup a RubyMine project based on the wiki which was nicely explaining everything step by step, but I wasn't able to actually load the sketchup script I made. It took me a while to get that Sketchup wouldn't load my script because it was outside of the plugin directory.

As the example in the wiki actually point to the folder "C:\Users\tthomas2\SourceTree\testup-2" (as seen here), I was thinking that RubyMine was telling Sketchup a way or another to load my plugin.

Then I found this page explaining that I need a rb file inside of my plugin folder that adds my plugin folder to the $LOAD_PATH.

Anyway, I feel like this should be part of the wiki for the next person to wonder here to know about that.

At the bottom of the Licenseing tutorial module ...
"master/examples/99_license/ex_hello_license/main.rb"

    # Fetching a license here so that it will be checked by SketchUp during
    # startup. This will include the extension in the dialog that warns about
    # missing licenses.
    ext_id = '6cce9800-40b0-4dd9-9671-8d55a05ae1e8'
    ext_lic = Sketchup::Licensing.get_extension_license(ext_id)

This is a bit contradictory to the text in the self.create_cube method.

How about wrapping it within an init method ?

    def self.init
      # Fetching a license here so that it will be checked by SketchUp during
      # startup. This will include the extension in the dialog that warns about
      # missing licenses.
      ext_id = '6cce9800-40b0-4dd9-9671-8d55a05ae1e8'
      ext_lic = Sketchup::Licensing.get_extension_license(ext_id)
    end

    self.init()

... or don't assign the results to local variables?

    Sketchup::Licensing.get_extension_license(
      '6cce9800-40b0-4dd9-9671-8d55a05ae1e8'
    )

?

The "Ruby" VS Code extension by Peng Lv is now deprecated and will no longer install. It is referenced here:

https://github.com/SketchUp/sketchup-ruby-api-tutorials/wiki/VSCode-Debugger-Setup#preparing-the-ide

The new recommended extension is Ruby LSP, but it is not compatible with the tutorial launch.json.

Last line,

If you are working on you own examples you want to contribute back via a Pull Request you can use Examples.reload while you work to reload all the files.

is confusing, seems to have two different ideas fighting for control, and should likely be separated into two sentences, ie:

If you are working on **your** own examples, you can use `Examples.reload` while you work, to reload all the files.

If you wish to contribute some tutorials back to the project via a Pull Request, [ this sentence needs finishing or editing ] !!

Debug Configuration

There is not an error but debugging does not started, because folder "/src" does not exist by default.
"cwd": "${workspaceRoot}/src"
"remoteWorkspaceRoot": "${workspaceRoot}/src"

Add a Tutorial and Example for using the
Sketchup::Http::Request and Sketchup::Http::Response classes.

The little blurbs of sample code in each method, do not stitch together well into an example.

See Ruby docs for standard lib class Net::HTTP for example ideas:
http://ruby-doc.org/stdlib-2.2.4/libdoc/net/http/rdoc/Net/HTTP.html

Ref public forum thread:
New HTTP Request/Response Help

I have a faceA, a faceB, faceC, faceA contains faceB, I want to know how to have Ruby API to get faceA contains faceB. but not contain faceC

faceA.all_connected.grep(Sketchup::Face) 

this can find faceB, but also faceC

help! !
if there is somebody can tell me how to make a sketchup plugin, I wanna enhance the function of sketchup, especially on exporting behavior.
thanks and all !!!

Hi,

There maybe a simple fix for this but as far as I can tell I followed the instructions here for setting the VSCode environment up for debugging ruby extensions for Sketchup 2016 to the letter.

However with Sketchup closed, when I choose [Tasks -> Run Tasks -> Debug Sketchup 2016] I get the following message in the Terminal:

Executing task: &'C:/Program Files/SketchUp/SketchUp 2016/SketchUp.exe' -rdebug 'ide port=7000' <

& was unexpected at this time.
The terminal process terminated with exit code: 1

It seems to be complaining about the & in front of the filepath, but if i remove it just complains about the C:

Can anyone assist with this?

Thanks
Alex

README has broken link to online tutorials.

If it was intentional to remove the online (web) API tutorials, then this repo's README should be edited to remove link.

And then also Issue #2 : Repo tutorials do not match online tutorials can be closed.