mirror of
https://github.com/moparisthebest/k-9
synced 2024-12-26 01:28:50 -05:00
74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
|
# ckChangeLog - An Android Library to display a Change Log
|
||
|
|
||
|
![Screenshot](https://github.com/cketti/ckChangeLog/raw/master/screenshot_1.png)
|
||
|
![Screenshot](https://github.com/cketti/ckChangeLog/raw/master/screenshot_2.png)
|
||
|
|
||
|
This library provides an easy way to display a change log in your app.
|
||
|
|
||
|
## Features
|
||
|
|
||
|
* Uses a simple XML file as source
|
||
|
* Supports partial translations
|
||
|
|
||
|
Repository at <https://github.com/cketti/ckChangeLog>.
|
||
|
|
||
|
|
||
|
## Usage
|
||
|
|
||
|
1. Create the master change log in `res/raw/changelog.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>
|
||
|
|
||
|
2. Create translations of this file under language-specific versions of `res/xml`, e.g. `res/xml-de`.
|
||
|
|
||
|
3. 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();
|
||
|
}
|
||
|
|
||
|
|
||
|
## Changelog
|
||
|
|
||
|
### Version 0.1
|
||
|
* Initial release
|
||
|
|
||
|
|
||
|
## Acknowledgments
|
||
|
|
||
|
This library is based on:
|
||
|
* [android-change-log](http://code.google.com/p/android-change-log/) by Karsten Priegnitz
|
||
|
* [Inscription](https://github.com/MartinvanZ/Inscription/) by [Martin van Zuilekom](https://github.com/MartinvanZ/)
|
||
|
|
||
|
Other contributors:
|
||
|
* You? Pull requests welcome!
|
||
|
|
||
|
|
||
|
## License
|
||
|
|
||
|
Copyright (C) 2012 Christian Ketterer (cketti)
|
||
|
|
||
|
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.
|