Contributing to Andor's Trail - Contribution Guide

Discussions of the development process of the game.
User avatar
Zukero
Lead Developer
Posts: 1958
Joined: Thu Jul 21, 2011 9:56 am
android_version: 8.0
Location: Eclipse

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

Post by Zukero » Thu Jan 30, 2014 4:11 pm

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.
Lvl: 78, XP: 8622632, Gold: 271542, RoLS: 1, ElyR: -, RoL: -, ChaR: 1, GoLF: 1, ShaF: 1, SRoV: 1, VSH: 1, WMC: 1, GoW: 1
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2

User avatar
Moerit
VIP
Posts: 105
Joined: Wed Oct 16, 2013 6:44 pm
android_version: 4.1 - Jellybean

Re: Contributing to Andor's Trail

Post by Moerit » Fri Jun 27, 2014 6:35 pm

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
Lvl: 16, XP: 47538, Gold: 474, RoLS: 0, ElyR: 0, RoL: 0, ChaR: 0, GoLF: 0, ShaF: 0, SRoV: 0, VSH: 0, WMC: 0, GoW: 0
HP: 151, AC: 248%, AD: 29-40, AP: 4, ECC: 22%, CM: -, BC: 160%, DR: 5

noamik
Posts: 38
Joined: Wed Apr 23, 2014 10:20 am
android_version: 2.3 - Gingerbread

Re: Contributing to Andor's Trail

Post by noamik » Tue Jul 01, 2014 7:29 pm

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 ...

ghormoon
Posts: 69
Joined: Sat Feb 23, 2019 6:10 am
android_version: 7.1 - Nougat

Re: Contributing to Andor's Trail - Contribution Guide

Post by ghormoon » Tue Feb 26, 2019 7:34 am

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.

User avatar
Zukero
Lead Developer
Posts: 1958
Joined: Thu Jul 21, 2011 9:56 am
android_version: 8.0
Location: Eclipse

Re: Contributing to Andor's Trail - Contribution Guide

Post by Zukero » Tue Feb 26, 2019 7:45 am

Nope. I think it's 24 currently...
Lvl: 78, XP: 8622632, Gold: 271542, RoLS: 1, ElyR: -, RoL: -, ChaR: 1, GoLF: 1, ShaF: 1, SRoV: 1, VSH: 1, WMC: 1, GoW: 1
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2

ghormoon
Posts: 69
Joined: Sat Feb 23, 2019 6:10 am
android_version: 7.1 - Nougat

Re: Setup the build environment

Post by ghormoon » Tue Feb 26, 2019 9:38 am

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? :)

Gonk
Posts: 15
Joined: Mon Mar 04, 2019 8:45 pm
android_version: 8.1 - Oreo

List of quests or features where I could help

Post by Gonk » Thu Mar 07, 2019 7:22 pm

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

User avatar
rijackson741
Posts: 2652
Joined: Tue Aug 20, 2013 2:04 am
android_version: 9.0 - Pie
Location: Somewhere in Dhayavar

Re: Contributing to Andor's Trail - Contribution Guide

Post by rijackson741 » Fri Mar 08, 2019 1:32 am

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.
Level:68, XP:5672461, PV:497, FQ:62
HP:220, AC:247, AD:46-58, AP:3, ECC:23%, CM:3, BC:171, DR:3
Gold: 222889 | RoLS:1, RoL:1, GoW:1, VSH:1, RoFLS:1
HH:1, WA:1, CS:2, Cl:1, IF:4, Ev:3, Re:2, WP:DA:1, WP:1S:1, AP:L:1, FS:DW:2, S:DW:1

User avatar
Zukero
Lead Developer
Posts: 1958
Joined: Thu Jul 21, 2011 9:56 am
android_version: 8.0
Location: Eclipse

Re: Contributing to Andor's Trail - Contribution Guide

Post by Zukero » Fri Mar 08, 2019 12:33 pm

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.
Lvl: 78, XP: 8622632, Gold: 271542, RoLS: 1, ElyR: -, RoL: -, ChaR: 1, GoLF: 1, ShaF: 1, SRoV: 1, VSH: 1, WMC: 1, GoW: 1
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2

Gonk
Posts: 15
Joined: Mon Mar 04, 2019 8:45 pm
android_version: 8.1 - Oreo

Re: Contributing to Andor's Trail - Android Studio

Post by Gonk » Mon Mar 11, 2019 10:33 pm

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.

Post Reply