RE: NetBeans Development Setup
I have always assumed that (1) and (2) are true. My "solution" is to stay on a single private branch based on the latest NetBeans release (currently 11.3), rather than the master branch, and pile up a few different patches before I start making Pull Requests. That way I normally only have to compile modules that actually have changed source files in them (by invoking "ant"). Only once I'm ready to start making a few pull requests in batch do I switch to the NetBeans master branch, pull the latest changes, create a PR branch, and apply my patch(es) (via "git cherry-pick"). I don't even rebuild on my own machine at that point--the automatic Travis build that starts when you create a PR will work as a sanity check of this "rebase". Other useful commands are "git rebase upstream/master" (assuming "upstream" is set to https://github.com/apache/netbeans ) and "git rebase -i HEAD~10" (or such) for squashing or reordering commits for PR creation purposes. Are you on Windows, Linux, or MacOS? -- Eirik -Original Message- From: Korney Czukowski Sent: Thursday, February 27, 2020 2:59 AM To: dev@netbeans.apache.org Subject: NetBeans Development Setup Hi, I've read an older thread with the same name and while there's a lot of useful information, I could really use some clarification on working with branches: 1. I assume whenever I decide to pull changes from upstream, a full ant build is necessary, and there's no way around it, correct? 2. When I work on my branch to fix an issue in one of the NetBeans modules and then switch to another branch to work on a different module, is full build (or cluster build, if applicable) necessary again? It would appear so to me, because I've seen some weird exceptions occurring when running a module after switching branches. But the full build takes a huge amount of time and is often interrupted eg. when it can't download something from gitbox.apache.org, etc. So I'm trying to find a way to avoid it whenever possible, because otherwise the time that could be spent on debugging and fixing issues is actually being spent on waiting for build, without being able to do anything else. Thanks.
Re: NetBeans Development Setup
And ide-branding is here:
https://github.com/apache/netbeans/tree/master/nb/ide.branding
Gj
On Wed, May 22, 2019 at 10:10 AM Geertjan Wielenga
wrote:
> Thanks a lot, very useful.
>
> Build the basic project (mainly, JavaSE features): $ ant
> -Dcluster.config=basic
>
> Build the full project (including Groovy, PHP, JavaEE/JakartaEE, and
> JavaScript features): $ ant -Dcluster.config=full
>
> Build the NetBeans Platform: $ ant -Dcluster.config=platform
>
> Does the above help? I.e., "platform" is the underlying framework only,
> "basic" is "platform" together with the Java SE-related development
> features, such as the Java Editor, while "full" is everything, i.e., all
> the clusters (which are groups of related modules, which each have a
> dedicated folder in your installation directory.
>
> The reason why doing the Ant build is needed is that you need to have a
> binary of NetBeans to deploy your modules-in-development to and that binary
> needs to be created and is created during the build, in 'nbbuild/netbeans'.
>
> Does the above answer some of your questions?
>
> Gj
>
>
> On Wed, May 22, 2019 at 4:34 AM Lou Hamersly
> wrote:
>
>> Gj,
>>
>> Here's some feedback - sorry this got kind of long. The videos aren't so
>> outdated that I couldn't figure things out, so I just explained the issues
>> I see. Using NB 11 (running on JDK 12?) instead of NB 8.2 should be a big
>> improvement on the visuals.
>>
>> The readme on GitHub explains how to build with 4 different examples:
>> ant
>> ant -Dcluster.config=basic
>> ant -Dcluster.config=full
>> ant -Dcluster.config=platform
>>
>> I've used the default and full config versions, but I'm still not sure if
>> it really matters or even why you'd choose one or the other. More specifics
>> there would be nice.
>>
>> The fact that you need to do an Ant build before loading in the IDE is
>> fine, but unusual. For those used to "clone->open project->build" entirely
>> inside the IDE, it might help to explain "why" an Ant build is needed prior
>> to loading into the IDE. ("Won't the IDE do all that for us?") There seems
>> to be some "magic" happening here from an outsider's perspective.
>>
>> In the 1st video, you start out in the Favorites tab (which I never
>> really use). You could show the step to add a favorite which starts at the
>> root of the cloned "netbeans" folder. That would also eliminate the extra
>> "main" root folder that the video has (momentary confusion as I was
>> thinking about a standard Gradle file structure which includes "main", but
>> has nothing to do with this). This is admittedly nit-picky, so not crucial.
>>
>> 1st video, 1:48:
>> Platform Modules listed under Modules tab only has one item for me.
>> Hopefully this is just the way it works now, post JDK 9:
>> https://imgur.com/a/aVNrnJh
>>
>> 1st video, 2:30:
>> The Project Properties dialog->Libraries tab starts out very different
>> for me in NB 11.
>> https://imgur.com/a/iEeh3oB
>>
>> However running the project worked fine for me. Despite what the readme
>> says about build requirements, I didn't need to switch the project's
>> platform from the default JDK 12 for the module project's
>> properties->Libraries->Java Platform. (I suspect that may become an issue
>> later on and should be changed to JDK 8?)
>>
>> 2nd video:
>> Debugging worked fine, breakpoint was hit.
>>
>> 3rd video, 1:07:
>> Again only "platform" is listed: https://imgur.com/a/L6WrAgo
>>
>> Run, debug + breakpoint worked fine.
>>
>> 4th video:
>> The ide.branding folder doesn't seem to exist anymore, or it was moved. I
>> have the master branch checked out and I noticed some work is being done on
>> the splash screen so I guess this is why.
>>
>> 5th video:
>> Works fine, very nice.
>>
>> Some general comments:
>> -It might be useful to talk about what "magic" is going on with these
>> "module" project types, or point to where more information can be found if
>> it's documented elsewhere. Is it "injecting" a compiled module? Maybe
>> explain what "clusters" are and what their purpose is, etc. Good to know a
>> little about architecture/what's happening under the hood.
>>
>> -Readme specifies Oracle/OpenJDK 8 as a requirement. I had assumed that
>> the Azul Systems "Zulu" certified version of JDK 8 would work just fine--it
>> didn't. This seems to be why I saw some error flags earlier. Oops. (I have
>> lots of JDKs installed here...)
>>
>> -If you do updated videos, I suggest putting a link to them on the front
>> page at apache.org under Participate. Right now the link is on the pull
>> requests page, and I didn't notice the videos because it's a little
>> out-of-order. You need to be able to set up and build before even thinking
>> about a PR. So I didn't bother looking at the PR page for build and setup
>> info, and relied only on the GitHub/readme at first to get started.
>>
>> -I use Linux, just in case any of this can't be reproduced and it's
>> OS-related.
>>
>> Hopefully this helps some. I can provide
Re: NetBeans Development Setup
Gj,
Here's some feedback - sorry this got kind of long. The videos aren't so
outdated that I couldn't figure things out, so I just explained the issues I
see. Using NB 11 (running on JDK 12?) instead of NB 8.2 should be a big
improvement on the visuals.
The readme on GitHub explains how to build with 4 different examples:
ant
ant -Dcluster.config=basic
ant -Dcluster.config=full
ant -Dcluster.config=platform
I've used the default and full config versions, but I'm still not sure if it
really matters or even why you'd choose one or the other. More specifics there
would be nice.
The fact that you need to do an Ant build before loading in the IDE is fine,
but unusual. For those used to "clone->open project->build" entirely inside the
IDE, it might help to explain "why" an Ant build is needed prior to loading
into the IDE. ("Won't the IDE do all that for us?") There seems to be some
"magic" happening here from an outsider's perspective.
In the 1st video, you start out in the Favorites tab (which I never really
use). You could show the step to add a favorite which starts at the root of the
cloned "netbeans" folder. That would also eliminate the extra "main" root
folder that the video has (momentary confusion as I was thinking about a
standard Gradle file structure which includes "main", but has nothing to do
with this). This is admittedly nit-picky, so not crucial.
1st video, 1:48:
Platform Modules listed under Modules tab only has one item for me. Hopefully
this is just the way it works now, post JDK 9:
https://imgur.com/a/aVNrnJh
1st video, 2:30:
The Project Properties dialog->Libraries tab starts out very different for me
in NB 11.
https://imgur.com/a/iEeh3oB
However running the project worked fine for me. Despite what the readme says
about build requirements, I didn't need to switch the project's platform from
the default JDK 12 for the module project's properties->Libraries->Java
Platform. (I suspect that may become an issue later on and should be changed to
JDK 8?)
2nd video:
Debugging worked fine, breakpoint was hit.
3rd video, 1:07:
Again only "platform" is listed: https://imgur.com/a/L6WrAgo
Run, debug + breakpoint worked fine.
4th video:
The ide.branding folder doesn't seem to exist anymore, or it was moved. I have
the master branch checked out and I noticed some work is being done on the
splash screen so I guess this is why.
5th video:
Works fine, very nice.
Some general comments:
-It might be useful to talk about what "magic" is going on with these "module"
project types, or point to where more information can be found if it's
documented elsewhere. Is it "injecting" a compiled module? Maybe explain what
"clusters" are and what their purpose is, etc. Good to know a little about
architecture/what's happening under the hood.
-Readme specifies Oracle/OpenJDK 8 as a requirement. I had assumed that the
Azul Systems "Zulu" certified version of JDK 8 would work just fine--it didn't.
This seems to be why I saw some error flags earlier. Oops. (I have lots of JDKs
installed here...)
-If you do updated videos, I suggest putting a link to them on the front page
at apache.org under Participate. Right now the link is on the pull requests
page, and I didn't notice the videos because it's a little out-of-order. You
need to be able to set up and build before even thinking about a PR. So I
didn't bother looking at the PR page for build and setup info, and relied only
on the GitHub/readme at first to get started.
-I use Linux, just in case any of this can't be reproduced and it's OS-related.
Hopefully this helps some. I can provide clarifications or more specifics if
needed. Thanks,
-Lou
‐‐‐ Original Message ‐‐‐
On Tuesday, May 21, 2019 2:21 AM, Geertjan Wielenga wrote:
> OK, it's time to make a new and maybe more complete and simpler version of
> those YouTube videos -- if you can list what should be in that, and what
> was confusing, that will help in putting it together, also what you found
> helpful in the videos.
>
> When you have a moment, but no rush.
>
> Gj
>
> On Tue, May 21, 2019 at 9:13 AM Lou H lo...@protonmail.com.invalid wrote:
>
> > Yup, I've gone over it a few times. My concerns were from the video not
> > exactly matching what I was seeing. I believe I've been able to get things
> > working - just a little uncertainty.
> > -Lou
> > ‐‐‐ Original Message ‐‐‐
> > On Tuesday, May 21, 2019 1:44 AM, Geertjan Wielenga geert...@apache.org
> > wrote:
> >
> > > See the README, always, first:
> > > https://github.com/apache/netbeans/blob/master/README.md
> > > Tells you about how to build.
> > > I'd recommend you then simply open the module you want to work on, make
> > > your changes, and then run that module, which will start up your built
> > > NetBeans and which will install the changed module into it.
> > > Gj
> > > On Tue, May 21, 2019 at 4:49 AM Lou H lo...@protonmail.com.invalid
> > > wrote:
> > >
> > > > A few questions/observations:
Re: NetBeans Development Setup
OK, it's time to make a new and maybe more complete and simpler version of those YouTube videos -- if you can list what should be in that, and what was confusing, that will help in putting it together, also what you found helpful in the videos. When you have a moment, but no rush. Gj On Tue, May 21, 2019 at 9:13 AM Lou H wrote: > Yup, I've gone over it a few times. My concerns were from the video not > exactly matching what I was seeing. I believe I've been able to get things > working - just a little uncertainty. > > -Lou > > ‐‐‐ Original Message ‐‐‐ > On Tuesday, May 21, 2019 1:44 AM, Geertjan Wielenga > wrote: > > > See the README, always, first: > > > > https://github.com/apache/netbeans/blob/master/README.md > > > > Tells you about how to build. > > > > I'd recommend you then simply open the module you want to work on, make > your changes, and then run that module, which will start up your built > NetBeans and which will install the changed module into it. > > > > Gj > > > > On Tue, May 21, 2019 at 4:49 AM Lou H > wrote: > > > >> A few questions/observations: > >> > >> 1- How to do the Ant build wasn't mentioned, I did it like this: "ant > -Dcluster.config=full". Build was done with a user.build.properties file > inside netbeans/nbbuild containing "nbjdk.home=/home/lou/jdk/jdk8u212-b03" > (latest OpenJDK). Correct? > >> > >> 2- When adding a new NetBeans Platform (around 1:40 in the first > video), at first the dialog doesn't list any modules. By de-selecting and > re-selecting the built platform it only lists "RCP Platform". Bad? > >> > >> 3- @2:30 (first video), again only a "platform" module is listed, so > this doesn't look correct. However, I am able to create a new "Module > Suite" project (3rd video) and it seems to run fine. I've noticed that as I > load new module projects, the list in the platform dialog grows a little. > >> > >> 4- Does it matter which JDK is used to run your installed/main NB > (especially for debugging the dev-NB)? > >> > >> -Lou > >> > >> ‐‐‐ Original Message ‐‐‐ > >> On Monday, May 20, 2019 4:31 PM, Lou H > wrote: > >> > >>> Not sure how I missed that, relying on the GitHub readme too much I > guess. I'll take a look, thanks! > >>> > >>> -Lou > >>> > >>> Sent with ProtonMail Secure Email. > >>> > >>> ‐‐‐ Original Message ‐‐‐ > >>> On Monday, May 20, 2019 4:27 PM, Patrik Karlström pat...@trixon.se > wrote: > >>> > >>> > Have a look at > >>> > > http://netbeans.apache.org/participate/build-run-debug-tutorials.html > >>> > Den mån 20 maj 2019 kl 22:21 skrev Lou H lo...@protonmail.com.invalid > : > >>> > > >>> > > I've been looking for guidelines or instructions on how to set up > for NB > >>> > > development & debugging (inside NB), but it's difficult to search > on > >>> > > "compiling/building netbeans within netbeans" without getting hits > on... > >>> > > everything but that. > >>> > > How would you get started setting up a productive dev environment & > >>> > > workflow? Does it depend on what you're focusing on at the time? > (Gradle > >>> > > support, JavaFX support, etc.) > >>> > > -Lou > >>> > >>> -- > >>> > >>> To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > >>> For additional commands, e-mail: dev-h...@netbeans.apache.org > >>> > >>> For further information about the NetBeans mailing lists, visit: > >>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > >> > >> - > >> To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > >> For additional commands, e-mail: dev-h...@netbeans.apache.org > >> > >> For further information about the NetBeans mailing lists, visit: > >> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: NetBeans Development Setup
Yup, I've gone over it a few times. My concerns were from the video not exactly matching what I was seeing. I believe I've been able to get things working - just a little uncertainty. -Lou ‐‐‐ Original Message ‐‐‐ On Tuesday, May 21, 2019 1:44 AM, Geertjan Wielenga wrote: > See the README, always, first: > > https://github.com/apache/netbeans/blob/master/README.md > > Tells you about how to build. > > I'd recommend you then simply open the module you want to work on, make your > changes, and then run that module, which will start up your built NetBeans > and which will install the changed module into it. > > Gj > > On Tue, May 21, 2019 at 4:49 AM Lou H wrote: > >> A few questions/observations: >> >> 1- How to do the Ant build wasn't mentioned, I did it like this: "ant >> -Dcluster.config=full". Build was done with a user.build.properties file >> inside netbeans/nbbuild containing "nbjdk.home=/home/lou/jdk/jdk8u212-b03" >> (latest OpenJDK). Correct? >> >> 2- When adding a new NetBeans Platform (around 1:40 in the first video), at >> first the dialog doesn't list any modules. By de-selecting and re-selecting >> the built platform it only lists "RCP Platform". Bad? >> >> 3- @2:30 (first video), again only a "platform" module is listed, so this >> doesn't look correct. However, I am able to create a new "Module Suite" >> project (3rd video) and it seems to run fine. I've noticed that as I load >> new module projects, the list in the platform dialog grows a little. >> >> 4- Does it matter which JDK is used to run your installed/main NB >> (especially for debugging the dev-NB)? >> >> -Lou >> >> ‐‐‐ Original Message ‐‐‐ >> On Monday, May 20, 2019 4:31 PM, Lou H wrote: >> >>> Not sure how I missed that, relying on the GitHub readme too much I guess. >>> I'll take a look, thanks! >>> >>> -Lou >>> >>> Sent with ProtonMail Secure Email. >>> >>> ‐‐‐ Original Message ‐‐‐ >>> On Monday, May 20, 2019 4:27 PM, Patrik Karlström pat...@trixon.se wrote: >>> >>> > Have a look at >>> > http://netbeans.apache.org/participate/build-run-debug-tutorials.html >>> > Den mån 20 maj 2019 kl 22:21 skrev Lou H lo...@protonmail.com.invalid: >>> > >>> > > I've been looking for guidelines or instructions on how to set up for NB >>> > > development & debugging (inside NB), but it's difficult to search on >>> > > "compiling/building netbeans within netbeans" without getting hits on... >>> > > everything but that. >>> > > How would you get started setting up a productive dev environment & >>> > > workflow? Does it depend on what you're focusing on at the time? (Gradle >>> > > support, JavaFX support, etc.) >>> > > -Lou >>> >>> -- >>> >>> To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org >>> For additional commands, e-mail: dev-h...@netbeans.apache.org >>> >>> For further information about the NetBeans mailing lists, visit: >>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists >> >> - >> To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org >> For additional commands, e-mail: dev-h...@netbeans.apache.org >> >> For further information about the NetBeans mailing lists, visit: >> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: NetBeans Development Setup
See the README, always, first: https://github.com/apache/netbeans/blob/master/README.md Tells you about how to build. I'd recommend you then simply open the module you want to work on, make your changes, and then run that module, which will start up your built NetBeans and which will install the changed module into it. Gj On Tue, May 21, 2019 at 4:49 AM Lou H wrote: > A few questions/observations: > > 1- How to do the Ant build wasn't mentioned, I did it like this: "ant > -Dcluster.config=full". Build was done with a user.build.properties file > inside netbeans/nbbuild containing "nbjdk.home=/home/lou/jdk/jdk8u212-b03" > (latest OpenJDK). Correct? > > 2- When adding a new NetBeans Platform (around 1:40 in the first video), > at first the dialog doesn't list any modules. By de-selecting and > re-selecting the built platform it only lists "RCP Platform". Bad? > > 3- @2:30 (first video), again only a "platform" module is listed, so this > doesn't look correct. However, I am able to create a new "Module Suite" > project (3rd video) and it seems to run fine. I've noticed that as I load > new module projects, the list in the platform dialog grows a little. > > 4- Does it matter which JDK is used to run your installed/main NB > (especially for debugging the dev-NB)? > > -Lou > > ‐‐‐ Original Message ‐‐‐ > On Monday, May 20, 2019 4:31 PM, Lou H > wrote: > > > Not sure how I missed that, relying on the GitHub readme too much I > guess. I'll take a look, thanks! > > > > -Lou > > > > Sent with ProtonMail Secure Email. > > > > ‐‐‐ Original Message ‐‐‐ > > On Monday, May 20, 2019 4:27 PM, Patrik Karlström pat...@trixon.se > wrote: > > > > > Have a look at > > > http://netbeans.apache.org/participate/build-run-debug-tutorials.html > > > Den mån 20 maj 2019 kl 22:21 skrev Lou H lo...@protonmail.com.invalid: > > > > > > > I've been looking for guidelines or instructions on how to set up > for NB > > > > development & debugging (inside NB), but it's difficult to search on > > > > "compiling/building netbeans within netbeans" without getting hits > on... > > > > everything but that. > > > > How would you get started setting up a productive dev environment & > > > > workflow? Does it depend on what you're focusing on at the time? > (Gradle > > > > support, JavaFX support, etc.) > > > > -Lou > > > > -- > > > > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > > For additional commands, e-mail: dev-h...@netbeans.apache.org > > > > For further information about the NetBeans mailing lists, visit: > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > For additional commands, e-mail: dev-h...@netbeans.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > >
Re: NetBeans Development Setup
A few questions/observations: 1- How to do the Ant build wasn't mentioned, I did it like this: "ant -Dcluster.config=full". Build was done with a user.build.properties file inside netbeans/nbbuild containing "nbjdk.home=/home/lou/jdk/jdk8u212-b03" (latest OpenJDK). Correct? 2- When adding a new NetBeans Platform (around 1:40 in the first video), at first the dialog doesn't list any modules. By de-selecting and re-selecting the built platform it only lists "RCP Platform". Bad? 3- @2:30 (first video), again only a "platform" module is listed, so this doesn't look correct. However, I am able to create a new "Module Suite" project (3rd video) and it seems to run fine. I've noticed that as I load new module projects, the list in the platform dialog grows a little. 4- Does it matter which JDK is used to run your installed/main NB (especially for debugging the dev-NB)? -Lou ‐‐‐ Original Message ‐‐‐ On Monday, May 20, 2019 4:31 PM, Lou H wrote: > Not sure how I missed that, relying on the GitHub readme too much I guess. > I'll take a look, thanks! > > -Lou > > Sent with ProtonMail Secure Email. > > ‐‐‐ Original Message ‐‐‐ > On Monday, May 20, 2019 4:27 PM, Patrik Karlström pat...@trixon.se wrote: > > > Have a look at > > http://netbeans.apache.org/participate/build-run-debug-tutorials.html > > Den mån 20 maj 2019 kl 22:21 skrev Lou H lo...@protonmail.com.invalid: > > > > > I've been looking for guidelines or instructions on how to set up for NB > > > development & debugging (inside NB), but it's difficult to search on > > > "compiling/building netbeans within netbeans" without getting hits on... > > > everything but that. > > > How would you get started setting up a productive dev environment & > > > workflow? Does it depend on what you're focusing on at the time? (Gradle > > > support, JavaFX support, etc.) > > > -Lou > > -- > > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > For additional commands, e-mail: dev-h...@netbeans.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: NetBeans Development Setup
Not sure how I missed that, relying on the GitHub readme too much I guess. I'll take a look, thanks! -Lou Sent with ProtonMail Secure Email. ‐‐‐ Original Message ‐‐‐ On Monday, May 20, 2019 4:27 PM, Patrik Karlström wrote: > Have a look at > http://netbeans.apache.org/participate/build-run-debug-tutorials.html > > Den mån 20 maj 2019 kl 22:21 skrev Lou H lo...@protonmail.com.invalid: > > > I've been looking for guidelines or instructions on how to set up for NB > > development & debugging (inside NB), but it's difficult to search on > > "compiling/building netbeans within netbeans" without getting hits on... > > everything but that. > > How would you get started setting up a productive dev environment & > > workflow? Does it depend on what you're focusing on at the time? (Gradle > > support, JavaFX support, etc.) > > -Lou - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
