@djfoxer
Blog (220)
Komentarze (4k)
Recenzje (1)

Automatyczne wersjonowanie aplikacji mobilnych Android i iOS w Xamarin

@djfoxerAutomatyczne wersjonowanie aplikacji mobilnych Android i iOS w Xamarin02.02.2018 21:05

Xamarin pozwala na tworzenie aplikacji pod Androida i iOS używając jedynego słusznego języka programowania, czyli C# ;) Jednym z częstszych problemów na jakie się natkniemy podczas wrzucania naszych apek do marketów jest wersjonowanie aplikacji. W jaki sposób jednocześnie numerować kolejne wydania pod Androida i iOS, bez szukania za każdym razem plików, a także sterować numeracją tylko z jednego miejsca? Jest na to ciekawy sposób, poprzez eventy dostępne w csproj, pliku projektu w Visual Studio.

Numeracja pod Androida

Wrzucając aplikację do marketu Google musimy pamiętać o poprawnym uzupełnieniu pliku AndroidManifest.xml. Znajdują się w nim informacje odnośnie naszej aplikacji jak kompatybilność z SDK, uprawnienie i masę innych ustawień. W tym momencie interesują nas dwie właściwościowi:

  • android:versionCode - jest to numer (int) kolejnych wersji w markecie Google, nie jest on pokazywany dla użytkownika; numeracja jest dowolna, ale kolejne wydania muszą mieć rosnącą numery (np. 23, 24, itd.)
  • android:versionName - jest to wersja aplikacji (string), jaką widzi użytkownik, służy głównie do celów informacyjnych (np. 1.3.5)

Numeracja iOS

Wersjonowanie kolejnych wydań w AppStorze jest delikatnie inne niż pod Androidem. Jednakże również w tym przypadku numerację ustalamy w specjalnym pliku, jest nim Info.plist. Pod iOS musimy wziąć pod uwagę następujące pola:

  • CFBundleVersion - numer (string) wewnętrzny, niewidoczny dla użytkownika; kolejne wersje muszą mieć rosnącą numerację (np. 1.3.5, 1.3.6 itd.)
  • CFBundleShortVersionString - numer (string) widoczny dla użytkownika (np 1.3.5)

Wspólna numeracja

Na powyższym opisie widać, jasno że numeracja dla użytkownika może spokojnie być dowolnym numerem (android:versionName i CFBundleShortVersionString). W tym przypadku będziemy stosowali standardową numerację X.Y.Z

Problemem są jednak numery wewnętrzne, które są określają kolejne wersje aplikacji w markecie. Dla ułatwienia można spokojnie przyjąć, że numer CFBundleShortVersionString, CFBundleVersion i android:versionName będą identyczne (czyli wg schematu X.Y.Z). W celu ujednolicenia wersji również pod Androida, ustalimy odgórnie, iż numer android:versionCode będzie ostatnim numerem ze schematu, czyli Z i to on będzie podbijany przed każdą publikacją.

Zatem numeracja będzie następująca:

X.Y.Z np. 1.3.10

CFBundleShortVersionString = CFBundleVersion = android:versionName = X.Y.Z

android:versionCode = Z

przy czym pamiętamy, że za każdym razem, przed publikacją do sklepu, będziemy zwiększali numerację Z.

Automatyczna numeracja poprzez Visual Studio (programowanie w .csproj)

Nasza automatyczna numeracja będzie w skrócie wyglądała następująco. W jednym miejscu w solucji będziemy przechowywali numer aktualnej wersji aplikacji. Przy buildzie z tego miejsca pobieramy numer i wstrzykujemy do pliku AndroidManifest.xml w projekcie Android i Info.plist w projekcie iOS.

Ustaliliśmy zatem, iż numeracja obu aplikacji będzie wyglądała następująco: X.Y.Z. Musimy jeszcze znaleźć miejsce, gdzie będziemy przechowywali numer, skąd będziemy go wstrzykiwali do poszczególnych plików w projekcie.

W moim przypadku solucja Xamarin posiada projekt pod Androida, iOS i co najmniej jeden projekt będący bazowym projektem skąd pobierać będziemy numer (tutaj XamarinApp.Core). Użyłem do demonstracji Xamarina natywnego, ale równie dobrze może być to Xamarin.Forms, nie ma to znaczenia.

Numer wersji umieścimy w AssemblyInfo.cs:

[assembly: AssemblyVersion("1.2.5.0")]

jednakże będziemy pobierali stąd tylko trzy pierwsze numery (czyli 1.2.5), a ostatni z tej trójki będzie służył jako numer do versionCode do Androida i będzie musiał być podbijany za każdym razem, gdy zechcemy wrzucić apkę do marketu.

Kolejnym krokiem jest edycja plików .csproj dla Androida i iOS tak, aby przy buildzie pobierał z dll projektu (XamarinApp.Core, w którym mamy numerację globalną) numer wersji, a następnie obrabiał ją i wstrzykiwał do odpowiednich plików.

Autonumeracja w projekcie iOS

Zaczniemy od solucji iOS. W dowolnym edytorze otwieramy plik csproj dla projektu iOS. Przechodzimy na sam koniec pliku XML i tuż przed końcem zamknięciem tagu </Project> dodajemy własny kod:

<Target Name="BeforeBuild">
    <GetAssemblyIdentity AssemblyFiles="..\XamarinApp.Core\bin\$(Configuration)\XamarinApp.Core.dll">
      <Output TaskParameter="Assemblies" ItemName="AssemblyInfo" />
    </GetAssemblyIdentity>
    <PropertyGroup>
      <FullNumber>%(AssemblyInfo.Version)</FullNumber>
      <VersionNumber>$([System.Text.RegularExpressions.Regex]::Match(%(AssemblyInfo.Version), 
       `[^.][^.]*.[^.]*.[^.]*`))</VersionNumber>
    </PropertyGroup>
    <XmlPoke XmlInputPath="..\XamarinApp.iOS\Info.plist" 
       Query="//dict/key[. = 'CFBundleVersion']/following-sibling::string[1]"
       Value="$(VersionNumber)" />
    <XmlPoke XmlInputPath="..\XamarinApp.iOS\Info.plist" 
       Query="//dict/key[. = 'CFBundleShortVersionString']/following-sibling::string[1]"
       Value="$(VersionNumber)" />
</Target>

W tym przypadku określamy, że przed buildem danego projektu mobilnego (Name=BeforeBuild) będziemy pobierali z określonej dll AssemblyInfo (XamarinApp.Core builduje się jako pierwsze), a z niej numer w AssemblyVersion. Z numeru tego wyodrębniamy za pomocą Regexu trzy pierwsze numery i przypiszemy go do "zmiennej" VersionNumber.

Mając już numer otwieramy plik Info.plist, który jest typu XML i wstrzykujemy w odpowiednie pola CFBundleVersion i CFBundleShortVersionString numer z VersionNumber (użycie XmlPoke).

Autonumeracja w projekcie Android

Bardzo podobnie wygląda sprawa z solucją Androidową. Tu również edytujemy plik .csproj

<Target Name="AfterBuild">
    <GetAssemblyIdentity AssemblyFiles="..\XamarinApp.Core\bin\$(Configuration)\XamarinApp.Core.dll">
      <Output TaskParameter="Assemblies" ItemName="AssemblyInfo" />
    </GetAssemblyIdentity>
    <PropertyGroup>
      <FullNumber>%(AssemblyInfo.Version)</FullNumber>
      <VersionNumber>$([System.Text.RegularExpressions.Regex]::Match(%(AssemblyInfo.Version),
	`[^.][^.]*.[^.]*.[^.]*`))</VersionNumber>
      <BuildNumber>$(FullNumber.Split('.')[2])</BuildNumber>
    </PropertyGroup>
    <XmlPoke XmlInputPath="..\XamarinApp.Android\Properties\AndroidManifest.xml"
	Namespaces="&lt;Namespace Prefix='android' Uri='http://schemas.android.com/apk/res/android' /&gt;"
	Query="manifest/@android:versionCode" Value="$(BuildNumber)" />
    <XmlPoke XmlInputPath="..\XamarinApp.Android\Properties\AndroidManifest.xml"
	Namespaces="&lt;Namespace Prefix='android' Uri='http://schemas.android.com/apk/res/android' /&gt;"
	Query="manifest/@android:versionName" Value="$(VersionNumber)" />
</Target>

W tym przypadku również pobieramy wersję z AsseblyInfo, ale dodatkowo tworzymy nową "zmienną" BuildNumer, która jest ostatnim numerem z trzy-liczbowej wersji zapisanej w FullNumber.

Podobnie jak na iOS, otwieramy plik XML z ustawieniami aplikacji do marketu (tym razem to plik AndroidManifest.xml) i wstrzykujemy BuildNumer pod pole versionCode, a VersionNumber pod versionName.

W ten oto sposób sterujemy numeracją aplikacji na iOS i Androida w projekcie Xamarin z jednego miejsca, z uwzględnieniem wymagań poszczególnych sklepów mobilnych.

Na koniec

Zapanowanie nad numeracją aplikacji poprzez "programowanie w csproju" jest świetnym sposobem na pomoc w dewelopowaniu pod Xamarina. Spokojnie można także dodać numerację dla aplikacji UWP, jeśli zaszłaby taka potrzeba. Można również numer wersji trzymać w oddzielnym pliku xml, a wstrzykiwanie numerów dodać do jednego tylko csproja, który będzie podmieniał wersja dla dwóch różnych projektów mobilnych. Możliwości jest dużo.

Mam nadzieję, że wpis będzie pomocny przy tworzeniu kolejnych wersji aplikacji mobilnych w Xamarinie.

© dobreprogramy·Redakcja·Regulamin·Polityka prywatności·Reklama·Kontakt
Szanowna Użytkowniczko! Szanowny Użytkowniku!
×
Aby dalej móc dostarczać coraz lepsze materiały redakcyjne i udostępniać coraz lepsze usługi, potrzebujemy zgody na dopasowanie treści marketingowych do Twojego zachowania. Twoje dane są u nas bezpieczne, a zgodę możesz wycofać w każdej chwili na podstronie polityka prywatności.

Kliknij "PRZECHODZĘ DO SERWISU" lub na symbol "X" w górnym rogu tej planszy, jeżeli zgadzasz się na przetwarzanie przez Wirtualną Polskę i naszych Zaufanych Partnerów Twoich danych osobowych, zbieranych w ramach korzystania przez Ciebie z usług, portali i serwisów internetowych Wirtualnej Polski (w tym danych zapisywanych w plikach cookies) w celach marketingowych realizowanych na zlecenie naszych Zaufanych Partnerów. Jeśli nie zgadzasz się na przetwarzanie Twoich danych osobowych skorzystaj z ustawień w polityce prywatności. Zgoda jest dobrowolna i możesz ją w dowolnym momencie wycofać zmieniając ustawienia w polityce prywatności (w której znajdziesz odpowiedzi na wszystkie pytania związane z przetwarzaniem Twoich danych osobowych).

Od 25 maja 2018 roku obowiązuje Rozporządzenie Parlamentu Europejskiego i Rady (UE) 2016/679 (określane jako "RODO"). W związku z tym chcielibyśmy poinformować o przetwarzaniu Twoich danych oraz zasadach, na jakich odbywa się to po dniu 25 maja 2018 roku.

Kto będzie administratorem Twoich danych?

Administratorami Twoich danych będzie Wirtualna Polska Media Spółka Akcyjna z siedzibą w Warszawie, oraz pozostałe spółki z grupy Wirtualna Polska, jak również nasi Zaufani Partnerzy, z którymi stale współpracujemy. Szczegółowe informacje dotyczące administratorów znajdują się w polityce prywatności.

O jakich danych mówimy?

Chodzi o dane osobowe, które są zbierane w ramach korzystania przez Ciebie z naszych usług, portali i serwisów internetowych udostępnianych przez Wirtualną Polskę, w tym zapisywanych w plikach cookies, które są instalowane na naszych stronach przez Wirtualną Polskę oraz naszych Zaufanych Partnerów.

Dlaczego chcemy przetwarzać Twoje dane?

Przetwarzamy je dostarczać coraz lepsze materiały redakcyjne, dopasować ich tematykę do Twoich zainteresowań, tworzyć portale i serwisy internetowe, z których będziesz korzystać z przyjemnością, zapewniać większe bezpieczeństwo usług, udoskonalać nasze usługi i maksymalnie dopasować je do Twoich zainteresowań, pokazywać reklamy dopasowane do Twoich potrzeb. Szczegółowe informacje dotyczące celów przetwarzania Twoich danych znajdują się w polityce prywatności.

Komu możemy przekazać dane?

Twoje dane możemy przekazywać podmiotom przetwarzającym je na nasze zlecenie oraz podmiotom uprawnionym do uzyskania danych na podstawie obowiązującego prawa – oczywiście tylko, gdy wystąpią z żądaniem w oparciu o stosowną podstawę prawną.

Jakie masz prawa w stosunku do Twoich danych?

Masz prawo żądania dostępu, sprostowania, usunięcia lub ograniczenia przetwarzania danych. Możesz wycofać zgodę na przetwarzanie, zgłosić sprzeciw oraz skorzystać z innych praw wymienionych szczegółowo w polityce prywatności.

Jakie są podstawy prawne przetwarzania Twoich danych?

Podstawą prawną przetwarzania Twoich danych w celu świadczenia usług jest niezbędność do wykonania umów o ich świadczenie (tymi umowami są zazwyczaj regulaminy). Podstawą prawną przetwarzania danych w celu pomiarów statystycznych i marketingu własnego administratorów jest tzw. uzasadniony interes administratora. Przetwarzanie Twoich danych w celach marketingowych realizowanych przez Wirtualną Polskę na zlecenie Zaufanych Partnerów i bezpośrednio przez Zaufanych Partnerów będzie odbywać się na podstawie Twojej dobrowolnej zgody.