JarCasting
JarCasting JarCasting

ckChangeLog Library

An Android Library to display a Change Log

License

License
GroupId

GroupId

de.cketti.library.changelog
ArtifactId

ArtifactId

ckchangelog
Last Version

Last Version

1.2.2
Release Date

Release Date
Type

Type

aar
Description

Description

ckChangeLog Library
An Android Library to display a Change Log
Project URL

Project URL

https://github.com/cketti/ckChangeLog
Source Code Management

Source Code Management

https://github.com/cketti/ckChangeLog

Download ckchangelog

Filename Size
ckchangelog-1.2.2.pom
ckchangelog-1.2.2.aar 13 KB
ckchangelog-1.2.2-sources.jar 5 KB
ckchangelog-1.2.2-javadoc.jar 261 bytes
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/de.cketti.library.changelog/ckchangelog/ -->
<dependency>
    <groupId>de.cketti.library.changelog</groupId>
    <artifactId>ckchangelog</artifactId>
    <version>1.2.2</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/de.cketti.library.changelog/ckchangelog/
implementation 'de.cketti.library.changelog:ckchangelog:1.2.2'
// https://jarcasting.com/artifacts/de.cketti.library.changelog/ckchangelog/
implementation ("de.cketti.library.changelog:ckchangelog:1.2.2")
'de.cketti.library.changelog:ckchangelog:aar:1.2.2'
<dependency org="de.cketti.library.changelog" name="ckchangelog" rev="1.2.2">
  <artifact name="ckchangelog" type="aar" />
</dependency>
@Grapes(
@Grab(group='de.cketti.library.changelog', module='ckchangelog', version='1.2.2')
)
libraryDependencies += "de.cketti.library.changelog" % "ckchangelog" % "1.2.2"
[de.cketti.library.changelog/ckchangelog "1.2.2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

ckChangeLog - An Android Library to display a Change Log

Screenshot Screenshot

This library provides an easy way to display a change log in your app.

Features

  • Displays changes since the last app update
  • Can display the complete change log history
  • Uses a simple XML file as source
  • Supports partial translations
  • Easily extendable to use something other than a dialog

Repository at https://github.com/cketti/ckChangeLog.

Usage

  1. Create the master change log in res/xml/changelog_master.xml. Formatted like this:
<?xml version="1.0" encoding="utf-8"?>
<changelog>
    <release version="1.1" versioncode="11" >
        <change>Totally new and shiny version</change>
    </release>
    <release version="1.0" versioncode="10" >
        <change>Fixed: A bug fix</change>
        <change>Some other changes I can't quite remember</change>
    </release>
    <release version="0.1" versioncode="1">
        <change>First release</change>
    </release>
</changelog>

  1. Create translations of this changelog_master.xml file in files named changelog.xml under language-specific versions of res/xml/, e.g. res/xml-de/changelog.xml.

  2. Display the change log dialog by putting the following code in your activity's onCreate() method:

ChangeLog cl = new ChangeLog(this);
if (cl.isFirstRun()) {
    cl.getLogDialog().show();
}

Include the library

The easiest way to add ckChangeLog to your project is via Gradle. Just add the following lines to your build.gradle:

dependencies {
    compile 'de.cketti.library.changelog:ckchangelog:1.2.2'
}

To tell Gradle where to find the library, make sure build.gradle also contains this:

repositories {
    mavenCentral()
}

Customize labels

In order to change the labels of the dialog add the following items to your strings.xml:

  <string name="changelog_full_title">Change Log</string>
  <string name="changelog_title">What\'s New</string>
  <string name="changelog_ok_button">OK</string>
  <string name="changelog_show_full">More…</string>

Changelog

Version 1.2.2 (2015-01-09)

  • Added Ukrainian translation

Version 1.2.1

  • Add support for AboutLibraries
  • Fix build scripts so Javadoc JAR is properly created

Version 1.2.0

  • Made constant DEFAULT_CSS public
  • Changed internals to make it easier to read the change log from different sources
  • Added public method getChangeLog(boolean) that returns a list of ReleaseItems
  • Changed minSdkVersion to 4
  • Switched to Gradle as build system
  • Added Greek, Spanish, Polish, and Russian translation

Version 1.1.0

  • Added method skipLogDialog()
  • Added Slovak and German translation

Version 1.0.0

  • Breaking change! Moved master translation from res/raw/changelog.xml to res/xml/changelog_master.xml
  • Added German translation of the sample app

Version 0.1

  • Initial release

Acknowledgments

This library is based on:

Other contributors:

  • See here
  • You? Please create pull requests against the dev branch

License

Copyright (C) 2012-2015 cketti and contributors

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.

Versions

Version
1.2.2
1.2.1
1.2.0