<h1 id="gradle">Gradle<a aria-hidden="true" class="anchor-heading icon-link" href="#gradle"></a></h1>
<h2 id="what-is-it">What is it?<a aria-hidden="true" class="anchor-heading icon-link" href="#what-is-it"></a></h2>
<p>Gradle is a build automation tool</p>
<ul>
<li>It makes as few assumptions as possible with your project, and thus it is built to be flexible enough to support almost any type of software.</li>
</ul>
<p>Gradle only re-runs jobs when inputs/outputs have changed.</p>
<ul>
<li>therefore, caches are utilized</li>
</ul>
<p>Gradle runs on the JVM</p>
<ul>
<li>an implication here is that build logic can use the standard Java APIs.</li>
</ul>
<p>At first, we have only a <code>build.gradle</code> file. When we run <code>gradle wrapper</code>, some files are generated for us:</p>
<ul>
<li><code>gradle/wrapper/gradle-wrapper.jar</code></li>
<li><code>gradle/wrapper/gradle-wrapper.properties</code></li>
<li><code>gradlew</code></li>
<li><code>gradlew.bat</code></li>
</ul>
<h3 id="build-lifecycle">Build Lifecycle<a aria-hidden="true" class="anchor-heading icon-link" href="#build-lifecycle"></a></h3>
<p>Gradle evaluates and executes build scripts in three build phases of the Build Lifecycle:</p>
<h4 id="initialization">Initialization<a aria-hidden="true" class="anchor-heading icon-link" href="#initialization"></a></h4>
<p>Sets up the environment for the build and determine which projects will take part in it.</p>
<h4 id="configuration">Configuration<a aria-hidden="true" class="anchor-heading icon-link" href="#configuration"></a></h4>
<p>Constructs and configures the task graph for the build. Determines which tasks need to run and in which order, based on the task the user wants to run.</p>
<h4 id="execution">Execution<a aria-hidden="true" class="anchor-heading icon-link" href="#execution"></a></h4>
<p>Runs the tasks selected at the end of the configuration phase.</p>
<h2 id="terminology">Terminology<a aria-hidden="true" class="anchor-heading icon-link" href="#terminology"></a></h2>
<h3 id="projects">Projects<a aria-hidden="true" class="anchor-heading icon-link" href="#projects"></a></h3>
<p>Projects are the things that Gradle builds.</p>
<p>Projects contain a build script (<code>build.gradle</code>)</p>
<ul>
<li>Builds scripts define tasks, dependencies, plugins, and other configuration for that project.</li>
<li>A single build can contain one or more projects and each project can contain their own subprojects.</li>
</ul>
<h3 id="tasks">Tasks<a aria-hidden="true" class="anchor-heading icon-link" href="#tasks"></a></h3>
<p>Tasks contain the logic for executing some work—​compiling code, running tests or deploying software.</p>
<p>Most often, we'll use existing tasks.</p>
<ul>
<li>ex. built-in Java <code>Test</code> task, which runs tests.</li>
</ul>
<p>Tasks themselves consist of:</p>
<ul>
<li><em>Actions</em>: pieces of work that do something, like copy files or compile source</li>
<li><em>Inputs</em>: values, files and directories that the actions use or operate on</li>
<li><em>Outputs</em>: files and directories that the actions modify or generate</li>
</ul>
<h3 id="plugins">Plugins<a aria-hidden="true" class="anchor-heading icon-link" href="#plugins"></a></h3>
<p>Plugins allow you to introduce new concepts into a build beyond tasks, files and dependency configurations</p>
<ul>
<li>ex. most language plugins add the concept of <em>source sets</em> to a build.</li>
</ul>
<p>Plugins provide a means of reusing logic and configuration across multiple projects.</p>
<h3 id="build">Build<a aria-hidden="true" class="anchor-heading icon-link" href="#build"></a></h3>
<h3 id="shadowjar">shadowJar<a aria-hidden="true" class="anchor-heading icon-link" href="#shadowjar"></a></h3>
<p>ShadowJar is a plugin for the Gradle build system that provides a convenient way to create "fat" or "uber" JAR files</p>
<ul>
<li>A fat JAR file is a self-contained archive that includes not only your application's compiled classes but also all its dependencies. It allows you to package your application into a single JAR file that can be easily distributed and executed, without requiring users to manage separate JAR files for dependencies.</li>
</ul>
<hr>
<strong>Children</strong>
<ol>
<li><a href="/notes/mzdq6pxclhpbbrt6fu2i49x">Build</a></li>
</ol>
<hr>
<strong>Backlinks</strong>
<ul>
<li><a href="/notes/7b5l4b6fi65n7sv9org5q1l">Maven</a></li>
<li><a href="/notes/jj6zwxaydojypx02ouxuzhu">Jenv</a></li>
</ul>

Gradle

tech

This Dendron vault of tech knowledge is organized according to domains and their sub-domains, along with specific implementation of those domains.

For instance, Git itself is a domain. Sub-domains of Git would include topics like `commit`,
`tags`, `reflog` etc., while implementations of each of those could be `cli`, `strat`
(strategies), `inner` (inner workings), and so on.

The goal of the wiki is to present data in a manner that is from the perspective
of a querying user. Here, a user is a programmer wanting to get key information
from a specific domain. For instance, if a user wants to use postgres functions
and hasn't done them in a while, they should be able to query
`postgres.functions` to see basic implementations, as well as common patterns
that have been employed in the past.

This wiki has been written with myself in mind. While learning each of these
domains, I have been sensitive to the "aha" moments and have noted down my
insights as they arose. I have refrained from capturing information that I
considered obvious or otherwise non-beneficial to my own understanding.

As a result, I have allowed myself to use potentially arcane concepts to help
explain others. For example, in my note on [[unit testing|testing.method.unit]],
I have made reference to the [[microservices|general.arch.microservice]] note.
The ability to analogize between different concepts captured in different notes
allows an opportunity to build strong generalized understandings. Given that
you'd have to understand microservices to be able to draw that same parallel
that I've already drawn, these links won't work for everyone. Since these notes
are written for myself, I have been fine with taking these liberties and leaning
on them heavily.

What I hope to gain from this wiki is the ability to step away from any
given domain for a long period of time, and be able to be passably useful for
whatever my goals are within a short period of time. Of course this is all
vague sounding, and really depends on the domain along with the ends I am
trying to reach.

To achieve this, the system should be steadfast to:
- be able to put information in relatively easily, without too much thought
	required to its location. While location is important, Dendron makes it easy
	to relocate notes, if it becomes apparent that a different place makes more
	sense.
- be able to extract the information that is needed, meaning there is a
	high-degree in confidence in the location of the information. The idea is
	that information loses a large amount of its value when it is unfindable.
	Therefore, a relatively strict ideology should be used when determining
	where a piece of information belongs.
	- Some concepts might realistically belong to multiple domains. For instance, the concept of *access modifiers* can be found in both `C#` and `Typescript`. Therefore, this note should be abstracted to a common place, such as [[OOP|paradigm.oop]].

This Dendron notebook is the sister vault to the general [Second Brain](https://tech.kyletycholiz.com).

## Tags
Throughout the garden, I have made use of tags, which give semantic meaning to the pieces of information.

- `ex.` - Denotes an *example* of the preceding piece of information
- `spec:` - Specifies that the preceding information has some degree of *speculation* to it, and may not be 100% factual. Ideally this gets clarified over time as my understanding develops. I try to go back after I have better understood the topic and clear out the notes of `spec:` tags
- `anal:` - Denotes an *analogy* of the preceding information. When I can, I attempt to link concepts to others that I have previously learned.
- `mn:` - Denotes a *mnemonic*
- `expl:` - Denotes an *explanation*

## Resources
### UE (Unexamined) Resources
Often, I come across sources of information that I believe to be high-quality. They may be recommendations or found in some other way. No matter their origin, I may be in a position where I don't have the time to fully examine them (and properly extract notes), or I may not require the information at that moment in time. In cases like these, I will add reference to a section of the note called **UE Resources**. The idea is that in the future when I am ready to examine them, I have a list of resources that I can start with. This is an alternative strategy to compiling browser bookmarks, which I've found can quickly become untenable.

### E (Examined) Resources
Once a resource has been thoroughly examined and has been mined for notes, it will be moved from *UE Resources* to *E Resources*. This is to indicate that (in my own estimation), there is nothing more to be gained from the resource that is not already in the note.

### Resources
This heading is for inexhaustible resources. 
- A prime example would be a quality website that continually posts articles.  - Another example would be a tool, such as software that measures frequencies in a room to help acoustically treat it.
