Page 3 of 7

Appendix B - View Javadoc and/or sources of the Android API

Posted: Thu Jan 30, 2014 4:11 pm
by Zukero
Appendix B - View Javadoc and/or sources of the Android API

If you are OK with giving ~600MB of hard drive to have an integrated local documentation & sources for the Android API (all the code made by Google, not the one made by Andor's Trail dev team), follow these instructions:

Open the "SDK Manager" ("<ADT Root>/SDK Manager.exe"), and under the API version you are using (API 18 these days), select the "Documentation for the Android SDK" and the "Sources for the Android SDK" items, and click "Install packages...".

Once complete, under eclipse's "Package Explorer", right-click on "AndorsTrail/Android 4.3/android.jar" (you Android version may vary) and select "Build Path->Configure Build Path...".

In the opened "AndorsTrail Project Properties" window, make sure that the "Libraries" tab is select, and expand the "Android 4.3/android.jar" node.
Select "Javadoc location", and click on "Edit...". Make sure "Javadoc URL" is selected, and click on "Browse...". Navigate to "<ADT Root>/sdk/docs/reference/" and click Ok. Click "Ok" in the other window as well.
Now, select "Source attachment" (above "Javadoc location"), and click on "Edit...". Select "External location" and click on "External folder...". Navigate to "<ADT Root>/sdk/sources/android-18/" and click "Ok". Click "Ok" in the other window as well.

Finally, click yet again on the "Ok" button to close the "AndorsTrail Project Properties" window.

Congratulations, you can now place your mouse cursor over any Android class or method name and see its documentation, and hit F3 when the cursor is in an Android class or method name to view its source.

Re: Contributing to Andor's Trail

Posted: Fri Jun 27, 2014 6:35 pm
by Moerit
After reading through all the suggestioned parts about git, i still had problems coming clear with eclipse.
I would like to suggest the following tutorial for all people who are not familiar with git and eclipse:

English Version
German Version

Re: Contributing to Andor's Trail

Posted: Tue Jul 01, 2014 7:29 pm
by noamik
I just wanted to add that I can run the emulator on a dual core i7 with almost native speed. Animations are a tad slower than on my device, but not by much. Maybe 80-90% speed. It's important to emulate an x86 atom though ...

Re: Contributing to Andor's Trail - Contribution Guide

Posted: Tue Feb 26, 2019 7:34 am
by ghormoon
is the API version still 19? I've noticed some warning on some property that it works from 21 up. it builds and runs, though.

Re: Contributing to Andor's Trail - Contribution Guide

Posted: Tue Feb 26, 2019 7:45 am
by Zukero
Nope. I think it's 24 currently...

Re: Setup the build environment

Posted: Tue Feb 26, 2019 9:38 am
by ghormoon
Zukero wrote: Sun Jan 26, 2014 11:09 pm
Unless you are very lucky, you should see in the "Console" tab at the bottom (remember, the "feedback area") a message in red like the following:

Code: Select all

[2014-01-22 11:48:43 - AndorsTrail] Unable to resolve target 'android-19'
This means that you do not have the android SDK that matches the one currently used by Andor's Trail.
Note what target the message references. In my example, it is "android-19", meaning I need version 19 of the SDK.
If you are lucky, and do not see this message, you can be sure it will appear someday when we upgrade the project to a newer one. So read the next steps anyway.
May I suggest editing this post? :)

List of quests or features where I could help

Posted: Thu Mar 07, 2019 7:22 pm
by Gonk
Hello, I hope you can help me.

I really like the game and want to give something back to the community. I would like to start with some simple tasks like fixing smaller bugs, translating or helping someone to create game content for his quest.

The bugs on github are very few and the german translations are all done. Is there a list of features or quests or something else, that is currently developed or planned and where I could help?

Thanks
Chris

Re: Contributing to Andor's Trail - Contribution Guide

Posted: Fri Mar 08, 2019 1:32 am
by rijackson741
Hello Gonk, and welcome to the forums.

We always appreciate help! The first thing you should do is download and install ATCS and Tiled. See the first post of this thread, and here: viewtopic.php?f=6&t=4806. Also look at the developers section of the wiki, here: wiki/test/andors_trail_wiki.html. Note that it is very out of date, especially regarding the content editor, but it nevertheless has useful information. Then just play around a little to get the hang of content creation. Edit a few existing maps to get the hang of Tiled, and learn how maps are built. Create a few items, monsters, NPCs with a small dialogue etc to learn the basics of content creation in ATCS. view all of this material as throw-away, and just a learning experience.

Then, start small. IMHO too many potential contributors give up because they try too much for their first project. You do not even need to add a quest to add something useful. For example, just a couple of maps, with an NPC you can trade with for some new items. That would be a complete piece of content we could add to the game. I added the watchtower for the last release. It's only one outside map and two inside maps, but it added something different, which makes the game more interesting. Once you get the hang of small pieces of content you can build up to bigger ones. Someone needs to work on Feygard :lol:

And don't be afraid to ask questions if you get stuck!

It's probably a good idea to PM the dev team with new content before you create too much of it. We can tell you what you are doing right and what you are doing wrong before you invest too much time on something that requires large changes.

Re: Contributing to Andor's Trail - Contribution Guide

Posted: Fri Mar 08, 2019 12:33 pm
by Zukero
If you want to have a first contact with the code, adding the "random" requirement type to dialogue replies is a rather easy task, completed with a couple of lines only.
Once done, there's also the integration of this in ATCS which is about as easy.

As stated by rijackson741 above, content creation is what we need most, but code contributions are appreciated too.

Re: Contributing to Andor's Trail - Android Studio

Posted: Mon Mar 11, 2019 10:33 pm
by Gonk
Thanks for your help.

I downloaded the sources and played with tiled and ATCS. My next step was to use Android Studio to build the project. Maybe using Android Studio was a mistake, because I had some issues that I could resolve, but now I am stuck because of the error "mergeDebugResources \xml\blackwater_mountain0.tmx: file name must end with .xml". Is there a current tutorial how to build AT with Android Studio or should I better switch to Eclipse?

Thanks again.