Lukdiplomin koodi on nyt arkistoitu

2021-01-18: Tämän lukudiplomisovelluksen koodi on nyt arkistoitu (ks. https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/archiving-repositories/), koska sovellusta ollaan päivittämässä. Lukudiplomisovelluksen päivitysversion koodi tullaan laittamaan myös Githubiin, Tampereen kaupunginkirjaston tilin alaisuuteen, kunhan sovellus saadaan julkaistua.

Lukudiplomi

Katso lisätietoja osoitteesta https://piki.verkkokirjasto.fi/web/arena/lukudiplomi-nuoret/ ja https://piki.verkkokirjasto.fi/web/arena/pirkanmaan_lukudiplomi/.

Kehitys

Kehittääksesi sovellusta eteenpäin tai tehdäksesi vain oman version nykyisestä lähdekoodista, tarvitset seuraavat ohjelmistot:

• Git (valinnainen; voit myös vain ladata lähdekoodit .zip-pakettina)
• NodeJS ja NPM
• Editori (esim. Atom, Visual Studio Code, jne.)
• Android Studio ja sen mukana tulevat työkalut jne., mm. emulaattori ja SDK -- Android-versiota varten.
• Xcode -- iOS-versiota varten

Vaiheet

Yleiset

Olettaen, että edellä mainitut ohjelmistot on asennettu ja ne toimivat, voit edetä asennettavan sovelluspaketin tekoon (APK tai IPA, riippuen kohdejärjestelmästä). Jatkossa ohjeet Android-version tekemiseen. iOS-version ohjeet myöhemmin.

Lähdekoodi. Kloonaa (tai vaihtoehtoisesti lataa .zip-paketti) lähdekoodin sisältävä repository.

$ git clone https://github.com/Tampereen-kaupunginkirjasto/lukudiplomi-react-native.git

Riippuvuudet. Asenna riippuvuudet. Tarvittavat riippuvuudet löytyvät package.json-tiedoston dependencies-kohdasta. Ne asennetaan seuraavilla komennoilla:

$ cd lukudiplomi-react-native
$ npm install

Luo myös Android ja iOS -kansiot seuraavasti:

$ ./node_modules/.bin/react-native android

Jos edellisen komennon yhteydessä esiintyy ongelmia, kokeile seuraavia ratkaisukeinoja asiaan (Stack Overflow ja Github Issue):

• https://stackoverflow.com/questions/43723958/react-native-android-project-not-found-maybe-run-react-native-android-first#
• facebook/react-native#9312

Android

Kun asennus on valmis, käynnistä Android-emulaattori. Voit tehdä tämän joko komentoriviltä tai sitten Android Studion kautta. Kun Android-emulaattori on käynnissä, luo ja asenna sovelluspaketti (APK) seuraavasti:

$ npm run android

Tämä komento luo sovelluspaketin ja asentaa sen emulaattoriin.

iOS

iOS-versiota on helpointa testata simulaattorissa. Edellyttäen, että Yleiset-kohdan vaiheet on suoritettu ja Xcoden uusin versio on asennettu, voidaan sovellus ajaa komennolla

$ npm run ios

Komento tekee sovelluksesta asennettavan paketin ja asentaa sen simulaattoriin.

Myös Xcodea voidaan käyttää. Repositoryn juurikansioon luotiin Yleiset-kohdassa omat kansionsa sekä Android että iOS -versioille. Kansiosta ios löytyy Xcoden projektitiedosto, joka voidaan avata Xcodessa. Tällöin sovelluksen voi asentaa Xcodesta simulaattorille.

Muu dokumentaatio

Katso docs-kansiosta.

Lisenssi

MIT-lisenssi. Katso lisätiedot LICENSE-tiedostosta.