Thought I’d add to this... Maybe some pointer to basic ide usage prerequisite before digging into advanced ide development tasks
Maybe include some basic git on this (in Netbeans) to show the git part. Maybe touch on forks and clones as well. After pulling, what happens next (i.e. open project or projects get automatically added, files are indexed in some way, etc.). Can one build (ant) Netbeans from within NBs? If so how? I’ve had the missing platform issue as mentioned earlier when adding the compiled platform. Can’t recall this but clearing out cache and user folders when applicable (and when) Maybe some additional configuration steps (defaults JDK, etc.) or other similar configuration options of interest to ide development Maybe how some of the existing testing is performed (unit tests, packages, suites, netcat,etc)? Maybe ticket basics (i.e. submitting issue, what to include, how to submit etc.) Maybe some more on dumps and how to produce and read them (i.e. showing x allows to isolate problem code area y,etc.) If there are fixes involved how to push/submit then? On any part of these, additional links where applicable. Eric Bresie ebre...@gmail.com > On May 22, 2019 at 2:11:21 AM CDT, Geertjan Wielenga <geert...@apache.org> > wrote: > 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 <geert...@apache.org> > 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 <lo...@protonmail.com.invalid> > > 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 clarifications or more specifics > > > if needed. Thanks, > > > > > > -Lou > > > > > > ‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐ > > > On Tuesday, May 21, 2019 2:21 AM, Geertjan Wielenga <geert...@apache.org> > > > 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: > > > > > > > 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 > > > lo...@protonmail.com.INVALID > > > > > > > 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 > > > > > > > > > > > > --------------------------------------------------------------------- > > > 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 > > > > > > > > > > > >
