Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Created Documentation #4

Merged
merged 2 commits into from
Oct 2, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
101 changes: 99 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,102 @@
# anidero
Render After Effects animations in JSON format on Android
# Anidero for Android

## Intro
An Android Library that renders After Effects animations
in JSON format

## Getting Started
For information on how to get started with Anidero,
take a look at our [Getting Started](docs/getting-started.md) guide.

## Submitting Bugs or Feature Requests
Bugs or feature requests should be submitted at our [GitHub Issues section](https://github.com/zeoflow/anidero/issues).

## How does it work?
### 1. Depend on our library

Anidero for Android is available through Google's Maven Repository.
To use it:

1. Open the `build.gradle` file for your application.
2. Make sure that the `repositories` section includes Google's Maven Repository
`google()`. For example:

```groovy
allprojects {
repositories {
google()
jcenter()
}
}
```

3. Add the library to the `dependencies` section:

```groovy
dependencies {
// ...
implementation 'com.zeoflow:anidero:<version>'
// ...
}
```

### 2. Add a Anidero component to your app
`activity_main.xml`

```xml
<!--
...
-->
<com.zeoflow.anidero.AnideroView
android:id="@+id/zAnideroView"
android:layout_width="match_parent"
android:layout_height="200dp"
android:layout_centerInParent="true"
app:anidero_loop="true" />
<!--
...
-->
```

### 3. Activity/Fragment Class
`MainActivity.java`

```java
public class MainActivity extends BindAppActivity<ActivityMainBinding, MainViewBinding>
{
//..
private AnideroView zAnideroView;
//..
@Override
protected void onCreate(@Nullable Bundle savedInstanceState)
{
//..
zAnideroView = findViewById(R.id.zAnideroView);
//..
zAnideroView.setAnimation("animation.json");
zAnideroView.playAnimation();
zAnideroView.setSpeed(1f);
//..
}
//..
}
```
###### `animation.json` is read from the \assets folder

## License
Copyright 2020 ZeoFlow

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

## 🏆 Contributors 🏆

Expand Down
99 changes: 99 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
# Anidero for Android

## Intro
An Android Library that renders After Effects animations
in JSON format

## Getting Started
For information on how to get started with Anidero,
take a look at our [Getting Started](docs/getting-started.md) guide.

## Submitting Bugs or Feature Requests
Bugs or feature requests should be submitted at our [GitHub Issues section](https://github.com/zeoflow/anidero/issues).

## How does it work?
### 1. Depend on our library

Anidero for Android is available through Google's Maven Repository.
To use it:

1. Open the `build.gradle` file for your application.
2. Make sure that the `repositories` section includes Google's Maven Repository
`google()`. For example:

```groovy
allprojects {
repositories {
google()
jcenter()
}
}
```

3. Add the library to the `dependencies` section:

```groovy
dependencies {
// ...
implementation 'com.zeoflow:anidero:<version>'
// ...
}
```

### 2. Add a Anidero component to your app
`activity_main.xml`

```xml
<!--
...
-->
<com.zeoflow.anidero.AnideroView
android:id="@+id/zAnideroView"
android:layout_width="match_parent"
android:layout_height="200dp"
android:layout_centerInParent="true"
app:anidero_loop="true" />
<!--
...
-->
```

### 3. Activity/Fragment Class
`MainActivity.java`

```java
public class MainActivity extends BindAppActivity<ActivityMainBinding, MainViewBinding>
{
//..
private AnideroView zAnideroView;
//..
@Override
protected void onCreate(@Nullable Bundle savedInstanceState)
{
//..
zAnideroView = findViewById(R.id.zAnideroView);
//..
zAnideroView.setAnimation("animation.json");
zAnideroView.playAnimation();
zAnideroView.setSpeed(1f);
//..
}
//..
}
```
###### `animation.json` is read from the \assets folder

## License
Copyright 2020 ZeoFlow

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
20 changes: 20 additions & 0 deletions docs/building-from-source.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
<!--docs:
title: "Building From Source"
layout: landing
section: docs
path: /docs/building-from-source/
-->

# Building From the Latest Source

If you'll be contributing to the library, or need a version newer than what has
been released, Anidero from ZeoFlow can also be built from source.
To do so:

Clone the repository:

```sh
git clone https://github.com/zeoflow/anidero.git
```

Then, build the library's AARs using Gradle
51 changes: 51 additions & 0 deletions docs/contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
<!--docs:
title: "Contributing"
layout: landing
section: docs
path: /docs/contributing/
-->

# General Contributing Guidelines

The Anidero contributing policies and procedures can be found in the
main Anidero documentation repository’s
[contributing page](https://github.com/zeoflow/anidero/blob/CONTRIBUTING.md).

To make a contribution, you'll need to be able to build the library from source
and run our tests.

## Building From Source

Take a look at our [instructions](building-from-source.md) on how to build the
library from source.

## Running Tests

Anidero for Android has JVM tests as well as Emulator tests.

To run the JVM tests, do:

```sh
./gradlew test
```

To run the emulator tests, ensure you have
[a virtual device set up](https://developer.android.com/studio/run/managing-avds.html)
and do:

```sh
./gradlew connectedAndroidTest
```

## Code Conventions

Since we all want to spend more time coding and less time fiddling with
whitespace, Anidero uses code conventions and styles to
encourage consistency. Code with a consistent style is easier (and less
error-prone!) to review, maintain, and understand.

#### Be consistent

If the style guide is not explicit about a particular situation, the cardinal
rule is to **be consistent**. For example, take a look at the surrounding code
and follow its lead, or look for similar cases elsewhere in the codebase.
42 changes: 42 additions & 0 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
<!--docs:
title: "Getting Started"
layout: landing
section: docs
path: /docs/getting-started/
-->

### 1. Depend on our library

Anidero for Android is available through Google's Maven Repository.
To use it:

1. Open the `build.gradle` file for your application.
2. Make sure that the `repositories` section includes Google's Maven Repository
`google()`. For example:

```groovy
allprojects {
repositories {
google()
jcenter()
}
}
```

3. Add the library to the `dependencies` section:

```groovy
dependencies {
// ...
implementation 'com.zeoflow:anidero:<version>'
// ...
}
```

Visit [MVN Repository](https://mvnrepository.com/artifact/com.zeoflow/anidero)
to find the latest version of the library.

## Contributors

Anidero for Android welcomes contributions from the community. Check
out our [contributing guidelines](contributing.md) before getting started.