Beginner friendly installation instructions

[Mike Fleischauer]

After looking at the getting started directions I noticed they skipped
over a number of steps and assumed a great deal of prior knowledge of
Eclipse, Git and Maven which would be a very big hang up for a new
developer or someone recently exposed to Java. So I put together an
extremely detailed installation guide for installing PlayN using
Eclipse, hopefully people find it useful. So if you are having
trouble getting PlayN up and installed or find the getting started
guide too vague, check it out.

http://www.gamefromscratch.com/post/2011/10/13/Getting-started-with-PlayN.aspx

[Jon Gill]

This looks like a really useful guide. Do you think you could also
add it as a new page in the PlayN wiki?

[Jon Gill]

The only other comment that I have is that I _believe_ that the m2e
plug-in comes pre-installed with the newest version of Eclipse.
Someone please correct me if I'm wrong, though.

[Mike Fleischauer]

That's what the Getting Started guide said, but reality disagreed with
them, at least with the version I downloaded (today Classic 3.7.1).

As to putting it in the Wiki, I have no issue with the contents being
put in the Wiki, but I am not sure as to having the time to actually
do it. Now, had I not used so many images... :)

On Oct 13, 7:37 pm, Jon Gill <jonag...@gmail.com> wrote:
> The only other comment that I have is that I _believe_ that the m2e
> plug-in comes pre-installed with the newest version of Eclipse.
> Someone please correct me if I'm wrong, though.
>
>
>
>
>
>
>
> On Thu, Oct 13, 2011 at 4:26 PM, Jon Gill <jonag...@gmail.com> wrote:
> > This looks like a really useful guide.  Do you think you could also
> > add it as a new page in the PlayN wiki?
>

> > On Thu, Oct 13, 2011 at 3:49 PM, Mike Fleischauer <retur...@gmail.com> wrote:
> >> After looking at the getting started directions I noticed they skipped
> >> over a number of steps and assumed a great deal of prior knowledge of
> >> Eclipse, Git and Maven which would be a very big hang up for a new
> >> developer or someone recently exposed to Java.  So I put together an
> >> extremely detailed installation guide for installing PlayN using
> >> Eclipse, hopefully people find it useful.  So if you are having
> >> trouble getting PlayN up and installed or find the getting started
> >> guide too vague, check it out.
>

> >>http://www.gamefromscratch.com/post/2011/10/13/Getting-started-with-P...

[Dorian Manning]

Also, those 2 options for git aren't the only ones. I use the egit plug-in for eclipse and found it much easier to use than the other options and the Team SVN eclipse plug-ins. I'm also a total novice with git and maven so it may be worth mentioning.

[Mike Fleischauer]

Good point, edited to reflect the additional option.

On Oct 13, 9:40 pm, Dorian Manning <dmannin...@gmail.com> wrote:
> Also, those 2 options for git aren't the only ones. I use the egit plug-in
> for eclipse and found it much easier to use than the other options and the
> Team SVN eclipse plug-ins. I'm also a total novice with git and maven so it
> may be worth mentioning.
>

[Jon Gill]

I believe the wiki editor will automatically inline any image URLs you
copy into it, so getting the images working shouldn't be a problem.

With your permission, I'd be happy to take the time to copy your
content over to the wiki, although I might take the liberty of
removing your criticisms from the final paragraph. They are
completely valid, but probably not the kind of thing we should
frontpage on the wiki. :)

[Mike Fleischauer]

Feel free, and understandable about the criticism removal. :)

If at some point however you could cite the source, that would be
appreciated.

[Mike Fleischauer]

In a bit of a follow up, I have done this companion post. It wasn't
until running ( frankly trying to figure out how to run! ) the HTML
target that I ran into a bit of a snag.

Simply put, the Maven eclipse plugin seems too be borked.

So this post covers installing ant, using it to configure Playn then
run the HTML target, also how to run the Ant run-html command from
within Eclipse. So, if you aren't a Java guru and are having a bit of
trouble figuring out how to run projects other than the Java
Application target, check this out. Hope you find it useful.

http://www.gamefromscratch.com/post/2011/10/27/Running-your-PlayN-app.aspx

[Jon Gill]

Okay, I've finally got around to copying over your blog post to the
wiki (with you accredited and linked at the top of the page). It's
currently hot-linking all of the images from Game From Scratch,
though, as I personally had neither the time nor the hosting to set
them up on another server. Please let me know if that's an issue for
you and I'll try and find another solution.

Also, would it be okay if I give your HTML5 the same treatment?

Here's the current wiki page for you to check out:
http://code.google.com/p/playn/wiki/BeginnerInstallationGuide?ts=1320283036&updated=BeginnerInstallationGuide

[Fred Sauer]

In case it helps...

Images can be uploaded as project files (http://code.google.com/p/playn/downloads/list) and then marked as "Deprecated" so they don't show up in the downloads list. After some experience with this technique, I recommend using filenames which include a date, e.g. 2011-11-03-image_thumb_40.png instead of just image_thumb_40.png

Fred

--

Fred Sauer

Developer Advocate

Google Inc.

1600 Amphitheatre Parkway

Mountain View, CA 94043
fre...@google.com

[Charlie Groves]

On Thu, Nov 3, 2011 at 10:56 AM, Fred Sauer <fre...@google.com> wrote:
> In case it helps...
> Images can be uploaded as project files
> (http://code.google.com/p/playn/downloads/list) and then marked as
> "Deprecated" so they don't show up in the downloads list. After some
> experience with this technique, I recommend using filenames which include a
> date, e.g. 2011-11-03-image_thumb_40.png instead of just image_thumb_40.png

Is it verboten to host images in the wiki repository? I just uploaded
an image from the tutorial via
http://code.google.com/p/playn/source/create?repo=wiki&path=/&mode=upload
and it's available at
http://wiki.playn.googlecode.com/git/images/git_path_setup.png

Charlie

[Fred Sauer]

Images related to the open source project, which this is, should be fine

[Jon Gill]

Either way, I've used the Downloads list per Fred's suggestion so that
the BeginnerInstallationGuide on our wiki is no longer hotlinking from
Games From Scratch.

[Mike Fleischauer]

Hi Jon, sorry I missed this post. The answer is yes and yes, although
it sounds like the image issue has already been resolved.

I have created a new installer as well ( detail in different post )
which for people using Windows, makes the process a heck of a lot
easier.

On Nov 2, 8:20 pm, Jon Gill <jonag...@gmail.com> wrote:
> Okay, I've finally got around to copying over your blog post to the
> wiki (with you accredited and linked at the top of the page).  It's
> currently hot-linking all of the images from Game From Scratch,
> though, as I personally had neither the time nor the hosting to set
> them up on another server.  Please let me know if that's an issue for
> you and I'll try and find another solution.
>
> Also, would it be okay if I give your HTML5 the same treatment?
>

> Here's the current wiki page for you to check out:http://code.google.com/p/playn/wiki/BeginnerInstallationGuide?ts=1320...

>
>
>
>
>
>
>
> On Thu, Oct 27, 2011 at 6:49 PM, Mike Fleischauer <retur...@gmail.com> wrote:
> > In a bit of a follow up, I have done this companion post.  It wasn't
> > until running ( frankly trying to figure out how to run! ) the HTML
> > target that I ran into a bit of a snag.
>
> > Simply put, the Maven eclipse plugin seems too be borked.
>
> > So this post covers installing ant, using it to configure Playn then
> > run the HTML target, also how to run the Ant run-html command from
> > within Eclipse.  So, if you aren't a Java guru and are having a bit of
> > trouble figuring out how to run projects other than the Java
> > Application target, check this out. Hope you find it useful.
>

> >http://www.gamefromscratch.com/post/2011/10/27/Running-your-PlayN-app...