Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gluonhq/attachextendedmac
Attach Extended with macOS implementations
https://github.com/gluonhq/attachextendedmac
Last synced: 6 days ago
JSON representation
Attach Extended with macOS implementations
- Host: GitHub
- URL: https://github.com/gluonhq/attachextendedmac
- Owner: gluonhq
- License: gpl-3.0
- Created: 2022-09-02T12:23:45.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-02T16:06:48.000Z (almost 2 years ago)
- Last Synced: 2023-08-06T18:25:18.083Z (over 1 year ago)
- Language: Java
- Size: 144 KB
- Stars: 0
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Attach Extended Mac #
Gluon [Attach](http://gluonhq.com/products/mobile/attach/) is the component that addresses the integration with low-level platform APIs in an end-to-end Java Mobile solution.
Attach provides an uniform, platform-independent API to access device and hardware features.
At runtime, the appropriate implementation (attach:desktop, attach:android, attach:ios) makes sure the platform specific code is
used to deliver the functionality.
Attach is open source, and it is freely licensed under the GPL license.
[Gluon](http://gluonhq.com) can provide [custom consultancy](http://gluonhq.com/services/consulting/) and [training](http://gluonhq.com/services/training/), commercial licenses, and open source [commercial support](http://gluonhq.com/services/commercial-support/), including daily and monthly releases.
_What happens if Attach doesn't include the service or feature that you require?_
You can always ask for support (see previous links) to develop this service for you, but you could try to implement it on your own.
Attach Extended Mac is a demo project intended to show how to extend and create custom Attach services outside Attach itself with macOS implementations.
As a custom service, it can't use the `com.gluonhq.attach` package name. This avoids the need of modifying the GluonFX plugins to include the service, and it can be used as a regular dependency, with its platform classifiers.
Once the service has been tested in all possible platforms, it could be contributed to Attach via [Pull Request](https://github.com/gluonhq/attach/pulls).
## Building Attach Extended for Mac ##
### Requisites ###
These are the requisites:
* A recent version of [JDK 11](http://jdk.java.net/11/) or superior
* Gradle 6.0 or superior.
* Attach Util 4.0.12 or superior
* A Mac with with MacOS X 10.14.4 or superior
* XCode 11.x or superior
### Attach Documentation ###
Read about Attach: [Device Interface](https://docs.gluonhq.com/#_device_interface)
The section [Building Attach](https://docs.gluonhq.com/#_building_attach) contains more advanced information.
### How to build and install Attach Extended ###
To build the Attach Extended Mac services on the project's root, run:
`./gradlew clean build`
If you want to install them, run:
`./gradlew clean publishToMavenLocal`
When the process finishes successfully, the different services can be added to a Gluon Mobile project.
For instance, the Log service for desktop can be added to the project like:
```
Gluon
https://nexus.gluonhq.com/nexus/content/repositories/releases
com.gluonhq.attachextendedmac
local-notifications
4.0.16-SNAPSHOT
com.gluonhq.attachextendedmac
local-notifications
4.0.16-SNAPSHOT
desktop
runtime
```
and used from the project like:
```
LocalNotificationService.create().ifPresent(service -> service.getNotifications().add(new Notification(...)));
```