17-04-2020, Saat: 23:27
Merhabalar.
- ARMandroid Splash Tool , delphi ile android proje geliştirenler için Splash Image üretmek ( açılış ekran resmi olarak nitelendirebiliriz. ) aynı zamanda kullanıcı tarafından tek bir satır kod yazmadan direkt "Delphi Project File" (.dproj) entegrasyon sağlamayı amaçlayan bir otomasyon yazılımıdır.
NOT: Resimleri küçülttüm, üzerilerine mouse ile basarak büyütebilirsiniz.
Resim Editörü Özelliği
- Resimleri boyutlandırma, transparan kısımları düz boyama veya arkada tekrarlanan resimcikler halinde ile duvar kağıdı oluşturma özelliği ile aynı zamanda minik bir resim editörüdür.
Animasyonlu Açılış Ekranı İmkanı
- En son hali ile eklenen bir özellik olarak; Animasyonlu GIF resimlerin varsayılanı (0) nolu ilk kare, ancak dilerseniz kareler içerisinden seçebileceğiniz bir tanesini başlangıç karesi kabul ederek, devamındaki kareleri, projeniz çalışır çalışmaz sürdüren animasyonlu açılış ekranı imkanı sunulmuştur.
Animasyonlu açılış ekranı için dinamik PAS dosyası
- Eğer Animasyonlu Splash Image opsiyonu tercih edilirse, projenize animasyon dosyası RESOURCE olarak kendiliğinden eklenir. Bu kaynağın çalışması için DPR dosyasının ilk satırına dinamik olarak üretilen PAS dosyası da otomatik olarak eklenecektir.
- Bu PAS dosyası minik bir animasyon motorudur. Application MainForm oluştuğu ana kadar bekleyecek, hemen Splash Layout oluşturacak, animasyon sona erince de kullandığı bütün kaynakları FREEandNIL ederek tüm kaynakları projenize iade edecektir.
Yedekler
- Üzerinde değişiklik yapılan dosyların BAK uzantılı yedekler üretilerek farkları inceleyebilirsiniz.
- XML tabanlı .dproj delphi proje dosyası kırılgan bir yapıdadır. Bu nedenle tüm PARSE işlemleri XMLDocument olarak uygulanır. Node yapısına sadık kalınır, güvenlidir.
Güzel bir know-how desteği sunacak kaynak kod içerir
- Yukarıda dinamik oluşturulan Delphi UNIT'inden bahsetmiştik. Bu unitin, DPR dosyanızda yer alması var olması ve çalışmas için yeterli. DPR'den kaldırılınca devre dışı kalır.
- Kendi içinde initialization / finalization ile yaşam döngüsüne girer.
- Kendi başına projenizin çalışma anını bekler, çalıştığında da Application.MainForm oluşmasını bekler.
- Daha sonra MainForm'un RESIZE olmasını bekler ki form kullanıcı telefon ekranı boyutuna göre boyutlandırılsın.
- En sonunda bir TLayout oluşturup, bu Splash Layout üzerinde tüm resimleme işlemlerini yaparak animasyonu başlatır
- Animasyon sona erdiğinde de bu Layout ve müştemilatı otomatik olarak silinir.
Uzun lafın kısası denemeye değer.
- Olası sorun, telefonun alt kısmındaki soft navigasyon butonlarının bir standardını henüz bulamadım. Kullanmakta olduğum Samsung Galaxy Note 8'in navigasyon butonları, kenarındaki sanal noktacığa çift dokununca gizleniyor. Bu durumdayken sistem metrikleri hala var kabul ediyor vb. donanımsal konular.
- Animasyonlu GIF dosyalarında da bazen standarda uymayanlar olabiliyor vb yazılımsal konular.
- Dolayısıyla kendinize ait telefonlar ile tecrübenizi paylaşırsanız, test projelerinizde değerlendirip bu başlık altından fikir ve görüşlerinizi sunarsanız memnun olurum.
Yeni kullanım videosu yapma fırsatım olunca koyarım, eskisi ile idare edelim.
Saygılarımla
Şimdi uzun süredir üzerinde çalıştığım motoru tamamlayarak artık BETA aşamasından çıkılmıştır.
Otomasyonun sağlaması açısından mobil cihazınızın ekran altındaki donanım ve/veya soft butonları algılama üzerine bir çalışma bayağı vaktimi aldı. Android Metric isimli fonksiyonu özellikle incelemenize sunuyorum.
- ARMandroid Splash Tool , delphi ile android proje geliştirenler için Splash Image üretmek ( açılış ekran resmi olarak nitelendirebiliriz. ) aynı zamanda kullanıcı tarafından tek bir satır kod yazmadan direkt "Delphi Project File" (.dproj) entegrasyon sağlamayı amaçlayan bir otomasyon yazılımıdır.
NOT: Resimleri küçülttüm, üzerilerine mouse ile basarak büyütebilirsiniz.
Resim Editörü Özelliği- Resimleri boyutlandırma, transparan kısımları düz boyama veya arkada tekrarlanan resimcikler halinde ile duvar kağıdı oluşturma özelliği ile aynı zamanda minik bir resim editörüdür.
Animasyonlu Açılış Ekranı İmkanı- En son hali ile eklenen bir özellik olarak; Animasyonlu GIF resimlerin varsayılanı (0) nolu ilk kare, ancak dilerseniz kareler içerisinden seçebileceğiniz bir tanesini başlangıç karesi kabul ederek, devamındaki kareleri, projeniz çalışır çalışmaz sürdüren animasyonlu açılış ekranı imkanı sunulmuştur.
Animasyonlu açılış ekranı için dinamik PAS dosyası - Eğer Animasyonlu Splash Image opsiyonu tercih edilirse, projenize animasyon dosyası RESOURCE olarak kendiliğinden eklenir. Bu kaynağın çalışması için DPR dosyasının ilk satırına dinamik olarak üretilen PAS dosyası da otomatik olarak eklenecektir.
- Bu PAS dosyası minik bir animasyon motorudur. Application MainForm oluştuğu ana kadar bekleyecek, hemen Splash Layout oluşturacak, animasyon sona erince de kullandığı bütün kaynakları FREEandNIL ederek tüm kaynakları projenize iade edecektir.
Yedekler - Üzerinde değişiklik yapılan dosyların BAK uzantılı yedekler üretilerek farkları inceleyebilirsiniz.
- XML tabanlı .dproj delphi proje dosyası kırılgan bir yapıdadır. Bu nedenle tüm PARSE işlemleri XMLDocument olarak uygulanır. Node yapısına sadık kalınır, güvenlidir.
Güzel bir know-how desteği sunacak kaynak kod içerir- Yukarıda dinamik oluşturulan Delphi UNIT'inden bahsetmiştik. Bu unitin, DPR dosyanızda yer alması var olması ve çalışmas için yeterli. DPR'den kaldırılınca devre dışı kalır.
- Kendi içinde initialization / finalization ile yaşam döngüsüne girer.
- Kendi başına projenizin çalışma anını bekler, çalıştığında da Application.MainForm oluşmasını bekler.
- Daha sonra MainForm'un RESIZE olmasını bekler ki form kullanıcı telefon ekranı boyutuna göre boyutlandırılsın.
- En sonunda bir TLayout oluşturup, bu Splash Layout üzerinde tüm resimleme işlemlerini yaparak animasyonu başlatır
- Animasyon sona erdiğinde de bu Layout ve müştemilatı otomatik olarak silinir.
Uzun lafın kısası denemeye değer.
- Olası sorun, telefonun alt kısmındaki soft navigasyon butonlarının bir standardını henüz bulamadım. Kullanmakta olduğum Samsung Galaxy Note 8'in navigasyon butonları, kenarındaki sanal noktacığa çift dokununca gizleniyor. Bu durumdayken sistem metrikleri hala var kabul ediyor vb. donanımsal konular.
- Animasyonlu GIF dosyalarında da bazen standarda uymayanlar olabiliyor vb yazılımsal konular.
- Dolayısıyla kendinize ait telefonlar ile tecrübenizi paylaşırsanız, test projelerinizde değerlendirip bu başlık altından fikir ve görüşlerinizi sunarsanız memnun olurum.
Yeni kullanım videosu yapma fırsatım olunca koyarım, eskisi ile idare edelim.
Program indirme linki burada...
Güncel Sürüm 1.5.4.504 (2020/05/04)
Saygılarımla
Şimdi uzun süredir üzerinde çalıştığım motoru tamamlayarak artık BETA aşamasından çıkılmıştır.
Otomasyonun sağlaması açısından mobil cihazınızın ekran altındaki donanım ve/veya soft butonları algılama üzerine bir çalışma bayağı vaktimi aldı. Android Metric isimli fonksiyonu özellikle incelemenize sunuyorum.unit ARMAN_AndroidSplashHelper;
interface
Uses
System.SysUtils, System.Types, System.UITypes, System.Classes,
System.Variants, System.ImageList,
FMX.Types, FMX.Controls, FMX.Forms, FMX.Graphics, FMX.Dialogs,
FMX.Objects, FMX.Layouts, FMX.Ani, FMX.Effects, FMX.ImgList;
Type
tAndroidBarHeights = record
sStatusBarHeight,
sNavigationBarHeight : Integer;
bNavBarExists,
bNavBarVisible : Boolean;
sScale : Single;
end;
Type
tAndroidSplashHelper = class(TObject)
private
Const
FAniResourceName = 'animation';
FSplashBackResourceName = 'splash_back';
FAniResourceAnimationCount = <FrameCount>; // Toplam Kare Sayısı
FAniResourceAnimationRowCount = <RowCount>; // Satır Sayısı
procedure OnAnimationFinish(sender: TObject);
function AndroMetrics(isFullScreenForm: boolean): tAndroidBarHeights;
var
FRectangle : TRectangle;
FRectangleBackGround : TRectangle;
FRectangleSolidBack : TRectangle;
FBitmapListAnimation : TBitmapListAnimation;
FBitmap : TBitmap;
FLoop : Boolean;
FSplashLayout : TLayout;
FSplashAniLayout : TLayout;
FTimer : TTimer;
FBarHeights : tAndroidBarHeights;
FMainForm : TForm;
procedure PrepareAnimation( aLoop: Boolean );
procedure SetMainForm( aMainForm: TForm );
procedure FTimerOnTimer( sender : TObject );
procedure MainFormResize(sender: TObject);
public
constructor create;
destructor destroy;
property MainForm : TForm write SetMainForm;
end;
var
xSplashAnimation : tAndroidSplashHelper;
implementation
{ tAndroidSplashHelper }
<Resource File>
Uses
Androidapi.JNI.Os,
Androidapi.Helpers,
Androidapi.JNI.GraphicsContentViewText,
Androidapi.JNI.Util,
Androidapi.JNIBridge, Androidapi.JNI.JavaTypes,
FMX.Platform,
FMX.Platform.Android;
constructor tAndroidSplashHelper.create;
begin
inherited;
FTimer := TTimer.Create(nil);
FTimer.Interval := 10;
FTimer.OnTimer := FTimerOnTimer;
FTimer.Enabled := True;
end;
destructor tAndroidSplashHelper.destroy;
begin
inherited;
end;
procedure tAndroidSplashHelper.FTimerOnTimer(sender: TObject);
begin
if Application.MainForm <> nil then
begin
FTimer.Enabled := False;
xSplashAnimation.MainForm := TForm( Application.MainForm );
FreeAndNil( FTimer );
end;
end;
procedure tAndroidSplashHelper.MainFormResize( sender: TObject );
begin
FSplashLayout.Position.X := 0;
FSplashLayout.Position.Y := 0;
FSplashLayout.Width := TForm(Sender).Width +1;
FSplashLayout.Height := TForm(Sender).Height +1;
FSplashAniLayout.Position.X := 0;
FSplashAniLayout.Position.Y := 0;
FSplashAniLayout.Width := TForm(Sender).Width +1;
FSplashAniLayout.Height := TForm(Sender).Height +1;
PrepareAnimation(false);
end;
procedure tAndroidSplashHelper.SetMainForm(aMainForm: TForm);
begin
FMainForm := aMainForm;
FMainForm.OnResize := MainFormResize;
FSplashLayout := TLayout.Create( aMainForm );
FSplashLayout.Parent := aMainForm;
FSplashLayout.Align := TAlignLayout.None;
FSplashAniLayout := TLayout.Create( aMainForm );
FSplashAniLayout.Parent := aMainForm;
FSplashAniLayout.Align := TAlignLayout.None;
end;
function tAndroidSplashHelper.AndroMetrics( isFullScreenForm : boolean ): tAndroidBarHeights;
{$IFDEF ANDROID}
var
ResourceID : Integer;
ScreenService : IFMXScreenService;
sAbis : string;
arrAbis : TJavaObjectArray<JString>;
i : Integer;
needCheckStatusBarHeight: boolean;
aView : JView;
Window : JWindow;
Metrics : JDisplayMetrics;
sStatusBarUNScaled,
sNavigationBarUNScaled,
sContentHeight,
sRealHeight : Single;
{$ENDIF}
begin
Result := default( tAndroidBarHeights );
{$IFDEF ANDROID}
if TOSVersion.Major >= 5 then
begin
sAbis := '';
arrAbis := TJBuild.JavaClass.SUPPORTED_ABIS;
for I := 0 to arrAbis.Length - 1 do
sAbis := sAbis + ',' + JStringToString(arrAbis.Items[I]);
sAbis := sAbis.trim([',']);
end
else
sAbis := JStringToString(TJBuild.JavaClass.CPU_ABI) + ',' + JStringToString(TJBuild.JavaClass.CPU_ABI2);
needCheckStatusBarHeight := ( sAbis.Contains('x86')
or sAbis.Contains('arm64-v8a')
or JStringToString(TJBuild.JavaClass.FINGERPRINT).Contains('intel')
) and (TOSVersion.Major >= 4) ;
if (TOSVersion.Major >= 5) or (needCheckStatusBarHeight) then
begin
// Scale
if TPlatformServices.Current.SupportsPlatformService(IFMXScreenService, IInterface(ScreenService))
then Result.sScale := ScreenService.GetScreenScale
else Result.sScale := 1.0;
// Status Bar Height ( UnScaled )
ResourceID := TAndroidHelper.Activity.getResources.getIdentifier( StringToJString('status_bar_height'),
StringToJString('dimen'),
StringToJString('android') );
if ResourceID > 0
then sStatusBarUNScaled := Trunc( TAndroidHelper.Activity.getResources.getDimensionPixelSize(ResourceID) );
// Navigation Bar Height ( UnScaled )
ResourceID := TAndroidHelper.Activity.getResources
.getIdentifier( StringToJString('navigation_bar_height'),
StringToJString('dimen'),
StringToJString('android') );
if ResourceID > 0
then sNavigationBarUNScaled := Trunc( TAndroidHelper.Activity.getResources.getDimensionPixelSize(ResourceID) );
// Content Height
ResourceID := TAndroidHelper.Activity.getResources
.getIdentifier( StringToJString('content'),
StringToJString('id'),
StringToJString('android') );
if ResourceID > 0
then begin
aView := TAndroidHelper.Activity.findViewById(ResourceID);
sContentHeight := aView.getHeight;
end;
// Real Height
Window := TJWindow.Wrap(( FMX.Platform.Android.MainActivity.getWindow as ILocalObject).GetObjectID);
Metrics := TJDisplayMetrics.Create;
Window.getWindowManager.getDefaultDisplay.getRealMetrics( Metrics );
sRealHeight := Metrics.heightPixels;
// Navigation Bar ( is Exists )
ResourceID := TAndroidHelper.Activity.getResources
.getIdentifier( StringToJString('config_showNavigationBar'),
StringToJString('bool'),
StringToJString('android') );
if ResourceID > 0
then Result.bNavBarExists := (ResourceID > 0) AND (TAndroidHelper.Activity.getResources.getBoolean(ResourceID));
Result.sStatusBarHeight := Round( sStatusBarUNScaled / Result.sScale );
Result.sNavigationBarHeight := Round( sNavigationBarUNScaled / Result.sScale );
if isFullScreenForm
then Result.bNavBarVisible := sRealHeight > sContentHeight // 2960 > 2792
else Result.bNavBarVisible := sRealHeight > ( sContentHeight + sStatusBarUNScaled ); // 2960 > 0:2876 - 1:2708 )
end;
{$ENDIF}
end;
procedure tAndroidSplashHelper.PrepareAnimation( aLoop: Boolean );
var
RC : TResourceStream;
begin
FBarHeights := AndroMetrics( True );
if FBarHeights.bNavBarVisible
then FSplashAniLayout.Padding.Top := FBarHeights.sNavigationBarHeight;
FRectangleSolidBack := TRectangle.Create( FSplashLayout );
With FRectangleSolidBack do begin
Parent := FSplashLayout;
Align := TAlignLayout.Client;
Stroke.Kind := TBrushKind.None;
Stroke.Thickness := 0;
Fill.Kind := TBrushKind.Solid;
Fill.Color := <SolidBackColor>;
end;
FRectangleBackGround := TRectangle.Create( FSplashLayout );
With FRectangleBackGround do begin
Parent := FSplashLayout;
Align := TAlignLayout.Client;
Stroke.Kind := TBrushKind.None;
Stroke.Thickness := 0;
Fill.Kind := TBrushKind.Solid;
Fill.Color := <SolidBackColor>;
end;
if FindResource(HInstance, FSplashBackResourceName, RT_RCDATA) <> 0 then
begin
RC := TResourceStream.Create(HInstance, FSplashBackResourceName, RT_RCDATA);
FBitmap := TBitmap.Create;
try
FBitmap.LoadFromStream(RC);
finally
RC.Free;
end;
FRectangleBackGround.Fill.Kind := TBrushKind.Bitmap;
FRectangleBackGround.Fill.Bitmap.Bitmap := FBitmap;
FRectangleBackGround.Margins.Top := 1;
FRectangleBackGround.Margins.Left := 0;
end;
FRectangle := TRectangle.Create( FSplashAniLayout );
With FRectangle do begin
Parent := FSplashAniLayout;
Align := TAlignLayout.Center;
Stroke.Kind := TBrushKind.None;
Stroke.Thickness := 0;
Fill.Kind := TBrushKind.Bitmap;
Fill.Bitmap.WrapMode := TWrapMode.TileStretch;
BringToFront;
end;
if NOT Assigned ( FRectangle.TagObject ) then
begin
if NOT Assigned( FBitmapListAnimation ) then
begin
FBitmapListAnimation := TBitmapListAnimation.Create(nil);
RC := TResourceStream.Create(HInstance, FAniResourceName, RT_RCDATA);
try FBitmapListAnimation.AnimationBitmap.LoadFromStream(RC);
finally RC.Free;end;
With FBitmapListAnimation do begin
Parent := FRectangle;
PropertyName := 'Fill.Bitmap.Bitmap';
AnimationCount := FAniResourceAnimationCount;
AnimationRowCount := FAniResourceAnimationRowCount;
Duration := 3;
AutoReverse := False;
AniFrameRate := 25;
Loop := aLoop;
Enabled := True;
OnFinish := OnAnimationFinish;
end;
end;
FRectangle.TagObject := FBitmapListAnimation;
With TBitmapListAnimation( FRectangle.TagObject ).AnimationBitmap do begin
FRectangle.Width := Round( TBitmapListAnimation( FRectangle.TagObject ).AnimationBitmap.Width / ( FBitmapListAnimation.AnimationCount / FBitmapListAnimation.AnimationRowCount ) );
FRectangle.Height := Round( TBitmapListAnimation( FRectangle.TagObject ).AnimationBitmap.Height / FBitmapListAnimation.AnimationRowCount );
end;
end;
TBitmapListAnimation(FRectangle.TagObject ).Start;
end;
procedure tAndroidSplashHelper.OnAnimationFinish(sender:TObject);
begin
FMainForm.OnResize := nil;
FSplashLayout.Visible := False;
FSplashAniLayout.Visible := False;
Application.MainForm.Padding.Top := FBarHeights.sStatusBarHeight;
FreeAndNil( FRectangleSolidBack );
FreeAndNil( FRectangleBackGround );
FreeAndNil( FRectangle );
FreeAndNil( FSplashLayout );
FreeAndNil( FSplashAniLayout );
FreeAndNil( FBitmapListAnimation );
if Assigned(FBitmap) then FreeAndNil(FBitmap);
end;
initialization
begin
xSplashAnimation := tAndroidSplashHelper.create;
end;
finalization
begin
FreeAndNil( xSplashAnimation );
end;
end.







