Document Project Generator / clean out old tools

[elliotwoods]

Hey all

A few sections of the repo need some love to put them in line with the project generator:

1. Readme's
2. Rogue old project generators
3. Document complementing tools

   Readme

The readme's in the root of the repo need some love none of them mention project generator

i feel like each should be a description of how to get to a working project generator on each of the respective platforms

also note:

• .vs2010 is missing
• readme.txt repeats information from the other readme's (i.e. it's a list of platform specific instructions) i think this should be perhaps a little description of oF and a few tips on how to get started

  Rogue old 'project generators' / documenting complementary tools for project generator

Here's things I can find in the repo which don't make sense to me at the moment:

• openFrameworks\scripts\????\compileAllExamples.bat * is this supposed to be run (optionally) after the project generator? * why is the project template within this folder?
• openFrameworks\scripts\????\createProjects.py \ if this isn't supposed to be used anymore, lets delete it immediately (we can always recover in emergencies)

and the 'other' folder in the root.. perhaps never took off?

[jedahan]

This issue has a few subissues, some of which have been fixed.

• [x] readme.md missing projectgenerator info (fixed in 87ce02fb3a2942be9c352a0c517197139a97f168)
• [x] vs2010 info missing (fixed in https://github.com/elliotwoods/openFrameworks/commit/a0bf8c62e9f818a349706b6dae24af2c74aea71d)
• [x] readme redundant/too verbose (looks good to me, short and sweet, /docs/ for more details)
• [ ] scripts/ undocumented? looks like an issue, maybe having a readme.md in the scripts directory would be helpful, and maybe mention in /docs

So, can we close this issue and split out one like "what is scripts?"

[julapy]

regarding those scripts... since the old project generator was removed from the devApps, i have no idea how to rebuild all iOS examples... is this done now using scripts? do these scripts have to be made for iOS? cc @ofZach

[ofZach]

the project generator has been moved to a submodule (separate repo). from the readme:

To set up the project generator submodule, use the command git submodule init then git submodule update whilst inside the openFrameworks repo.

[julapy]

hi @ofZach, thanks for the pointer. so i already had apps/projectGenerator/projectGeneratorSimple checked out but there doesn't seem to be any option for building all the iOS projects... like in the old apps/devApps/projectGenerator/ as far as i can tell, it can only create one project at a time. i must be missing something?

[ofZach]

in the submodule, there are three projects:

https://github.com/openframeworks/projectGenerator

use the "projectGeneratorLegacy" to generate projects (as before) or you can even use the command line tool (you need to pass in the OF path, the platform, recursive and the path to update examples on):

 ./projectGenerator -o"pathToOf" -x"ios" -r pathToOfExamples

for example, for me it looks like this:

 ./projectGenerator -o"/Users/zachlieberman/Documents/openframeworks/git/openFrameworks" -x"ios" -r /Users/zachlieberman/Documents/openframeworks/git/openFrameworks/examples

[julapy]

ah right... sorry i must be having some issues with my github repo, those folders are not in there for me and it doesn't seem to want to update the submodule. ok cool, thanks for pointing that out... i'll have to fix my issue with the github repo. thanks.

[armadillu]

how am I supposed to generate the Xcode project files for all the examples from a nightly build? It seems to only include the "simple" project generator; the one that allows to create a single project... Where did the legacy one go?

Or am I supposed to mix-match the missing project generator from github master? I thought the point of nightlies was to be able to test them as if they were releases... I was expecting them to have all the project files in place.

[arturoc]

the nightlies should have the projects in them but the last changes to the PG must have broken the package generation, will try to take a look tomorrow, meanwhile you can copy the commandline project and use that to generate all the examples

[armadillu]

Ok that's what I thought... But even 09-RC1 seems to be missing project files.

I'm using the "legacy PG" from master to build the project files and it works; the command line one doesn't compile for me (on OS X 10.10, latest master).

[ofZach]

the command line one should be fixed tomorrow -- I'm just working through a fix to a few kinks introduced with the templates and will regenerate new project files so it should be easy to get up and running with it. I have compiled older ones, but it's probably better to use the newer one given the changes to templates, etc. I have a PR that I'm working through, I just need a little time to make sure things work on ios, etc.

right now things are a little....

but should be settled shortly.

[bakercp]

@ofZach keep up the good work. I promised my students (first day of creative coding course today) an updated 0.9.0 compatible version of ofSketch for next week ... so here's to deadlines. :bowling:

[arturoc]

just fixed the PG in the server that creates the nightlies so tonight builds so have the project files in them